# YAML

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

CLion 使您能够使用 YAML 文件 (  `.yml` ,  `.yaml` ) 并支持以下功能：

* 语法高亮 您可以在 编辑器 | 配色方案 | YAML 对话框的 设置 页面（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）上更改 [颜色设置](configuring-colors-and-fonts.html)。

* [代码格式化](reformat-and-rearrange-code.html) 您可以在 设置 对话框的 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 页面访问与 YAML 相关的代码样式设置（ 编辑器 | 代码样式 | YAML ）。

* [检查](https://www.jetbrains.com/zh-cn/help/inspectopedia/YAML.html) CLion 能检测出 YAML 文档中的重复键、未使用的 [锚点](#anchors_and_aliases)等。

* [代码补全](auto-completing-code.html) 例如，您可以对包含 [JSON schema](#json_schema) 的 YAML 文档使用代码补全，或者完成锚点别名。

* [导航和搜索](navigating-through-the-source-code.html) 例如，您可以在 [锚点和别名](#anchors_and_aliases)之间导航。

* [查找锚点用法](#find-usages)

* [重命名重构](rename-refactorings.html)（例如，对 [anchors 和 aliases](#anchors_and_aliases)）

* [键入处理程序](#typing-handlers) CLion 会在键入时保持缩进、序列标记、中括号和引用。

让我们了解编辑器中可用的一些 YAML 特定功能。

## 锚点和别名

CLion 支持使用锚点和别名。 如果您在 YAML 文件中指定了一个新的 anchor，编辑器会显示一个警告，提示该 anchor 未被任何节点使用。

![YAML：未使用的锚点警告](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_unused_anchor_warning.png)

编辑器现在使您能够为此锚点 [完成](auto-completing-code.html) 别名。

![YAML：完成别名](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_complete_alias.png)

> **Note:**
> 您可以通过 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) 快捷键从别名 [导航](navigating-through-the-source-code.html) 到锚点。

要快速查找锚点的用法，将文本光标放在锚点上并按下 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS))。

![YAML：导航到别名](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_navigate_aliases.png)

CLion 支持 [重命名重构](rename-refactorings.html)锚点和别名：将文本光标放置在锚点上，然后按 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `⌘ ⌃ E` (Xcode), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `F2` (ReSharper), `F2` (ReSharper (macOS)), `Ctrl+Shift+R` (QtCreator), `⌘ ⌃ R` (QtCreator (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))。 或者，右键点击锚点并选择  `重构 | 重命名` 。

![重命名 YAML 锚点](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_rename_anchor.animated.gif)

使用   结构   工具窗口 ( `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS))) 快速浏览 YAML 文件。 要显示或隐藏   结构   工具窗口中重用锚点的元素，请点击 ![查看选项](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg) 使用   别名子树  。

![YAML 结构视图](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_structure_view.png)

## JSON schemas

CLion 支持使用 JSON schema 对 YAML 文件进行代码补全和检查。 CLion 可以自动推断模式（基于文件位置或结构），或者您也可以 [手动选择](#select-schema-for-file)。 例如，如果您在  `.github/workflows` 目录中有 GitHub Actions workflow 文件，CLion将基于从 [schemastore.org](http://schemastore.org)自动加载的  `github-workflow.json` 模式建议其选项：

![YAML：基于架构完成](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_complete_github_actions.png)

您可以使用   语言与框架 | 架构和 DTD | 远程 JSON 架构   对话框的   设置   页面（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）管理加载 JSON 架构。

如果必要，您可以在   语言与框架 | 架构和 DTD | JSON 架构映射  中指定所需的架构文件路径。

> **Tip:**
> 有关在 CLion 中管理 JSON schemas 的更多信息，请参阅 [使用来自 JSON Schema Store 的模式](json.html#ws_json_using_schemas)。

Procedure: 为文件选择一个 JSON schema

您可以为特定文件指定自定义模式。

1. 点击状态栏中的 schema 切换器。

![选择文件的架构](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_select_json_schema.png)

2. 在打开的列表中，选择一个建议的模式或点击   新建架构映射…  。 这将打开   JSON Schema 映射   设置，您可以在其中为文件指定本地或远程架构。

Procedure: 从架构获取属性

如果 CLion 检测到您的 YAML 文件的架构，您可以使用专门的操作快速将其所有属性插入到该文件中，从而无需手动输入。

* 如果架构包含必需的属性，而您只想插入这些特定属性，请在文件中的任意位置按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) (   显示上下文操作  ) 并选择   添加缺失属性  。

* 如果您想插入模式中可用的所有属性，请在文件中的任意位置按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（   显示上下文操作  ）并选择   填写 JSON 架构中的所有属性  。

Procedure: 使用 $schema 关键字

您还可以直接在文件中引用架构。

1. 在文件顶部，输入  `# $schema:` 。

2. 开始输入架构文件的名称。 将获得从 [schemastore.org](http://schemastore.org) 加载的架构名称补全。

如果您要使用本地 schema 文件，请指定相对于您要使用 schema 文件的位置的路径，例如，  `# $schema: ./my-schema.json` 。 这将启用与使用远程模式时相同的编码辅助，包括检查、补全和属性填充操作。

![从本地模式完成](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_completion_from_local_schema.animated.gif)

## 复制密钥

CLion 提供了复制 YAML 文件中指定选项的完整路径的功能。 您可以通过两种方式执行此操作：

* 将文本光标放在所需的键上并按下 `Ctrl+Alt+Shift+C` (Windows), `⌘ ⌥ ⇧ C` (macOS), `⌘ ⌥ ⇧ C` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ C` (macOS System Shortcuts), `Ctrl+Alt+Shift+C` (XWin), `Ctrl+Alt+Shift+C` (GNOME), `Ctrl+Alt+Shift+C` (KDE), `Ctrl+Alt+Shift+C` (Emacs), `Ctrl+Alt+Shift+C` (Sublime Text), `⌘ ⌥ ⇧ C` (Sublime Text (macOS)), `⌘ ⌥ ⇧ C` (Xcode), `Ctrl+Alt+Shift+C` (Visual Studio), `⌘ ⌥ ⇧ C` (Visual Studio (macOS)), `Ctrl+Alt+Shift+C` (ReSharper), `⌘ ⌥ ⇧ C` (ReSharper (macOS)), `Ctrl+Alt+Shift+C` (QtCreator), `⌘ ⌥ ⇧ C` (QtCreator (macOS)), `Ctrl+Alt+Shift+C` (NetBeans), `Ctrl+Alt+Shift+C` (Eclipse), `⌘ ⌥ ⇧ C` (Eclipse (macOS))。

* 将鼠标悬停在所需的键上，右键点击并选择 复制引用 。

![YAML：复制引用](https://resources.jetbrains.com/help/img/idea/2026.3/yaml_copy_references.png)

例如，在上面的图像中，将复制  `default.server.port` 。

> **Tip:**
> 您可以使用扁平化语法来 [搜索](searching-everywhere.html)嵌套的 YAML 键。 例如，要在此示例中找到  `port`  值，请按 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 两次并键入  `default.server.port` 。

## 键入处理程序

编辑 YAML 文件时，CLion 会为您保持缩进、序列标记、中括号和引用。 在以下示例中，  `<caret>`  标记文本光标位置。

### 序列标记

在序列项后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 时，CLion 会开始一个新项并自动插入  `-`  标记：

调整前:

```YAML
services:
  - nginx<caret>

```

调整后:

```YAML
services:
  - nginx
  - <caret>

```

如果在空项上再次按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))，CLion 会移除标记并将文本光标移动到父缩进级别，包括嵌套序列中。

当序列项包含映射时，按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 会在新的缩进行继续该映射，而不会添加第二个标记，即使标记插入已开启也是如此：

调整前:

```YAML
services:
  - name: web<caret>
  - name: db

```

调整后:

```YAML
services:
  - name: web
    <caret>
  - name: db

```

要删除空项，请在  `-`  标记后面的空格之后按 `Backspace` (Windows), `⌫` (macOS), `⌫` (IntelliJ IDEA Classic (macOS)), `⌫` (macOS System Shortcuts), `Backspace` (XWin), `Backspace` (GNOME), `Backspace` (KDE), `Backspace` (Emacs), `Backspace` (Sublime Text), `⌫` (Sublime Text (macOS)), `⌫` (Xcode), `Backspace` (Visual Studio), `⌫` (Visual Studio (macOS)), `Backspace` (ReSharper), `⌫` (ReSharper (macOS)), `Backspace` (QtCreator), `⌫` (QtCreator (macOS)), `Backspace` (NetBeans), `Backspace` (Eclipse), `⌫` (Eclipse (macOS))。 CLion 会在一次操作中移除  `-`  及其后面的空格。 如果值在同一行中跟在标记后面，CLion 仍会将标记连同空格一起移除，并将值保留在原位：

调整前:

```YAML
services:
  - <caret>nginx

```

调整后:

```YAML
services:
  <caret>nginx

```

> **Tip:**
> 要在不添加标记的情况下换行，请在   设置   对话框 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 的   编辑器 | 代码样式 | YAML   页面上禁用   自动在回车时插入连字符   选项。

### 缩进

按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 时，CLion 会使新行保持在与当前结构匹配的缩进级别：

* 在没有值的密钥之后，新行会多缩进一级。

* 在密钥-值对之后，新行会保持在同一级别。

* 在块标量指示符 ( `|` ) 之后，新行会多缩进一级，后续行会保持在该级别。

调整前:

```YAML
database:<caret>

```

调整后:

```YAML
database:
  <caret>

```

在块标量内，新行会位于标准块缩进处，即密钥下一级。 如果当前行手动进行了过度缩进，新行仍会使用标准块缩进，而不是与过度缩进的文本对齐。

如果在已完成条目下方仅包含空格的行上按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))，CLion 会保留手动设置的缩进，而不是重新对齐新行。

当在尚无项的序列中的空行上键入  `-`  后跟一个空格时，CLion 会更正标记缩进。 开启   缩进序列值   选项时，标记会放在比父密钥深一级的位置；关闭该选项时，标记会与父密钥对齐。 如果序列已包含项，标记会保留当前缩进。 可以在   设置   对话框 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 的   编辑器 | 代码样式 | YAML   页面上找到此选项。

### 中括号和引用                                                      

在密钥或值位置，CLion 会自动闭合流集合和带引用的标量。 键入  `[` 、  `{` 、  `"`  或  `'`  时，CLion 会插入匹配字符并将文本光标放在这对字符之间：

调整前:

```YAML
ports: <caret>

```

键入 [ 后:

```YAML
ports: [<caret>]

```

自动闭合仅适用于字符开始 YAML 结构标记的位置，例如新的密钥或值位置，或者现有流集合内部的某个位置。 当文本光标位于纯标量文本内或紧随其后时，CLion 会将该字符作为普通文本插入，而不会闭合任何内容。

在相同字符之前键入闭合  `]` 、  `}`  或引用时，CLion 会将文本光标移到其后，而不是插入重复字符。 但是，如果下一个字符是未配对的引用，则键入相同的引用字符会创建新的对，而不是移过现有字符。

要删除空的一对字符，请在两个字符之间按 `Backspace` (Windows), `⌫` (macOS), `⌫` (IntelliJ IDEA Classic (macOS)), `⌫` (macOS System Shortcuts), `Backspace` (XWin), `Backspace` (GNOME), `Backspace` (KDE), `Backspace` (Emacs), `Backspace` (Sublime Text), `⌫` (Sublime Text (macOS)), `⌫` (Xcode), `Backspace` (Visual Studio), `⌫` (Visual Studio (macOS)), `Backspace` (ReSharper), `⌫` (ReSharper (macOS)), `Backspace` (QtCreator), `⌫` (QtCreator (macOS)), `Backspace` (NetBeans), `Backspace` (Eclipse), `⌫` (Eclipse (macOS))，CLion 会将两者都移除。

> **Note:**
> 圆括号 (  `()` ) 在 YAML 中是普通字符，因此 CLion 既不会自动闭合，也不会跳过输入它们。 在块标量内，中括号和引用会作为纯文本插入，不会自动闭合。

### 移动密钥和项

要移动密钥、嵌套块或序列项，请将文本光标放在其上，然后按 `Ctrl+Shift+Up` (Windows), `⌘ ⇧ ↑` (macOS), `⌘ ⇧ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ ↑` (macOS System Shortcuts), `Ctrl+Shift+Up` (XWin), `Ctrl+Shift+Up` (GNOME), `Ctrl+Shift+Up` (KDE), `Ctrl+Shift+Up` (Emacs), `Ctrl+Shift+Up` (Sublime Text), `⌘ ⇧ ↑` (Sublime Text (macOS)), `⌘ ⌃ [` (Xcode), `Ctrl+Alt+Shift+Up` (Visual Studio), `⌃ ⌥ ⇧ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Shift+Up` (ReSharper), `⌃ ⌥ ⇧ ↑` (ReSharper (macOS)), `Ctrl+Shift+Up` (QtCreator), `Ctrl+Shift+Up` (QtCreator (macOS)), `Alt+Shift+Page Up` (NetBeans), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS)) 或 `Ctrl+Shift+Down` (Windows), `⌘ ⇧ ↓` (macOS), `⌘ ⇧ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ ↓` (macOS System Shortcuts), `Ctrl+Shift+Down` (XWin), `Ctrl+Shift+Down` (GNOME), `Ctrl+Shift+Down` (KDE), `Ctrl+Shift+Down` (Emacs), `Ctrl+Shift+Down` (Sublime Text), `⌘ ⇧ ↓` (Sublime Text (macOS)), `⌘ ⌃ ]` (Xcode), `Ctrl+Alt+Shift+Down` (Visual Studio), `⌃ ⌥ ⇧ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Shift+Down` (ReSharper), `⌃ ⌥ ⇧ ↓` (ReSharper (macOS)), `Ctrl+Shift+Down` (QtCreator), `Ctrl+Shift+Down` (QtCreator (macOS)), `Alt+Shift+Page Down` (NetBeans), `Alt+Down` (Eclipse), `⌥ ↓` (Eclipse (macOS))。 CLion 会移动整个条目，包括其嵌套内容，并保持缩进正确：

调整前:

```YAML
services:
  web<caret>:
    image: nginx
  db:
    image: postgres

```

调整后:

```YAML
services:
  db:
    image: postgres
  web<caret>:
    image: nginx

```

如果选择多个条目，CLion 会将选择范围扩展到完整条目并将它们作为一组移动。

> **Note:**
> 此行为仅在将映射或序列的第一个条目上移，或将最后一个条目下移时适用：其上方或下方没有可与之交换的内容。 仍可以像往常一样将第一个条目下移或将最后一个条目上移。
>
>
>
> 将最后一个条目下移时，只有带文本光标的密钥行会下移：该密钥行会保留为空条目，其原先的第一个子项会加入前一个条目。
>
>
>
> 将第一个条目上移时，只有带文本光标的行会上移：它会加入前一个条目，其父密钥会保留为空条目。

### 粘贴

将内容粘贴到 YAML 文件中时，CLion 会将其调整到目标结构：

* 粘贴到序列中的纯文本行会成为单独的项，每一项都有自己的 `-` 标记。

* 如果粘贴的行以 `-` 开头，或混合了带前缀和不带前缀的行，CLion 会规范化标记，使每一行都恰好有一个标记。

* 带点路径，如 `spring.datasource.url` ，会展开为嵌套密钥。

* 多行块会重新缩进，使其第一行与文本光标缩进匹配，而内部行会保留其相对缩进。 空行保持为空。

* 直接粘贴到现有密钥前面时，CLion 会重新缩进粘贴的块，并将现有密钥保留在其原始列。

例如，在映射位置粘贴  `spring.datasource.url` ：

调整前:

```YAML
config:
  <caret>

```

调整后:

```YAML
config:
  spring:
    datasource:
      url:<caret>

```

要开启或关闭带点密钥展开，请使用   设置   对话框 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 的   编辑器 | 常规 | 智能键 | YAML   页面上的   粘贴时自动展开密钥序列   选项。

