# 使用 `/settings` 命令更改设置

使用GitHub Copilot CLI斜杠命令查看和更改/settings的个人设置。

可以使用 `/settings` 斜杠命令在交互式 CLI 会话中查看和更改设置。 此命令控制用户级设置，例如是否 Copilot CLI 自动更新自身、界面使用的调色板、页脚中显示的内容和其他许多选项。

使用 `/settings` 来：

* **以交互方式浏览和编辑设置** - 自行运行 `/settings` 以打开可搜索编辑器，其中列出了每个设置及其当前值。
* **使用单个命令更改设置** - 运行 `/settings KEY VALUE` 以更改特定设置而不打开编辑器。
* **检查设置的值** - 运行 `/settings show KEY` 以显示设置的当前值。

你也可以使用 `/config`，它是 `/settings` 的别名。

使用 `/settings` 或 `/config` 所做的更改会写入你的个人设置文件（默认为 `~/.copilot/settings.json`），并在不同会话之间持续保留。

## 打开设置编辑器

若要以交互方式浏览和编辑设置，请输入不带参数的斜杠命令：

```copilot copy
/settings
```

编辑器列出了可以更改的每个设置，以及设置的当前值。 在列表中向上或向下移动时，编辑器底部会显示突出显示的设置的简短说明。 这样就可以浏览和编辑设置，而无需知道其确切名称。

有关可用设置的详细信息，请参阅 [GitHub Copilot CLI 配置目录](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#user-settings-copilotsettingsjson)。

当编辑器打开时，可以使用以下键盘快捷方式：

<!-- Force table-layout: auto so the first column shrinks to its content width on all viewports. The site applies table-layout: fixed below 544px, which would otherwise collapse the first column and make its keys overflow. -->

<table style="table-layout: auto;">
  <thead>
    <tr>
      <th style="white-space: nowrap;">关键</th>
      <th style="width: 100%;">Action</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="white-space: nowrap;">
<kbd>→</kbd> / <kbd></kbd></td>
      <td>在设置之间移动。</td>
    </tr>
    <tr>
      <td style="white-space: nowrap;"><kbd>/</kbd></td>
      <td>按设置的名称或说明搜索和筛选列表。</td>
    </tr>
    <tr>
      <td style="white-space: nowrap;">
<kbd>输入</kbd></td>
      <td>切换布尔型设置，或编辑其他类型的值。</td>
    </tr>
    <tr>
      <td style="white-space: nowrap;">
<kbd>Ctrl</kbd>+<kbd>R</kbd></td>
      <td>将突出显示的设置重置为其默认值。</td>
    </tr>
    <tr>
      <td style="white-space: nowrap;">
<kbd>Ctrl</kbd>+<kbd>E</kbd></td>
      <td>在配置的终端编辑器中打开 <code>settings.json</code> ，进行高级更改。</td>
    </tr>
    <tr>
      <td style="white-space: nowrap;">
<kbd>Esc</kbd></td>
      <td>清除当前搜索，或关闭编辑器。</td>
    </tr>
  </tbody>
</table>

大多数更改都会立即生效，例如，选择新值后，切换调色板会立即更新界面。

## 直接更改单个设置项

如果已知道要更改的设置，可以直接从 CLI 的提示框中设置此设置，而无需打开编辑器：

```copilot
/settings KEY VALUE
```

例如：

```copilot copy
/settings autoUpdate off
```

Copilot 写入值并确认该值，例如： `Set autoUpdate = false.`

> \[!NOTE]
> \*
> **布尔设置**可接受`on`/`off`或`true`/`false`。 例如，`/settings renderMarkdown on`。
> \*
> **具有固定选项集的设置** 接受其中一个值。 例如，`/settings theme dim` 或 `/settings banner never`。
> \*
> **嵌套设置** 使用虚线路径。 例如， `/settings footer.showBranch off` 隐藏页脚中的 Git 分支。

只需使用导航和 <kbd>Enter</kbd> 键即可配置采用设置值的设置，而无需记住确切的键或值。 例如，若要防止代理提出澄清问题，请执行以下操作：

1. 键入 `/settings`，不按 <kbd>Enter</kbd> 可显示选项列表。
2. 使用 <kbd>↓</kbd> 键在列表中向下移动，直到 `❯` 指向 `/settings askUser  Allow the agent to ask clarifying questions`，然后按 <kbd>Enter</kbd>。
3. 使用 <kbd>↓</kbd> 键在此设置的选项列表中向下移动，直到 `❯` 指向 `/settings askUser off`，然后按 <kbd>Enter</kbd>。
4. 再次按 <kbd>Enter</kbd> 以提交 `/settings askUser off` 命令。

   CLI 确认更改： `Set askUser = false.`

## 查看设置的有效值

若要显示某项设置可用的有效值，请输入不带值的 `/settings KEY`。 例如，若要查看 `theme` 的有效值：

```copilot copy
/settings theme
```

## 查看设置的当前值

若要显示设置的当前值，请使用 `show`。 例如：

```copilot copy
/settings show theme
```

这会输出一行，例如 `theme = high-contrast`。 此 `show` 表单可用于快速检查值或捕获日志中的设置。

## 更改需要重启的设置

大多数设置会立即生效，但有些设置只有在 Copilot CLI 重启后才会完全生效，例如 `experimental` 和代理设置。 更改其中一项时， Copilot 告知需要重启，并可能为你重启会话。

## 无法从命令行更改的设置

并非每个设置都可以通过内联 `/settings KEY VALUE` 方法进行编辑：

* **安全敏感设置**（例如更改凭据存储方式或运行 shell 命令的设置）被故意排除，因为将其翻转为一行且没有确认是有风险的。
* **列表和结构化设置**无法以内联方式设置。 按 `/settings`<kbd>Ctrl</kbd>+<kbd>E</kbd> 在配置的终端编辑器中打开 `settings.json` ，然后编辑该设置。
* **存储库或组织管理的设置** 会显示供参考，但其值来自这些源并替代你的个人值。 在用户设置中更改它们不起作用。

在每种情况下， Copilot 都会解释为何未应用更改，并将你指向正确的位置进行更改。

## 被 `/settings` 替换的命令

一些较旧的斜杠命令已并入 `/settings`。 它们仍然可用，但会显示一则提示，告诉你与之等效的 `/settings` 命令。

## 可能需要更改的设置

一些常用的设置包括：

* `autoUpdate` — 自动更新更新的 CLI 版本。
* `theme`— 调色板（`default`、、`github``dim`、`high-contrast`或`colorblind`）。
* `renderMarkdown` — 在终端中呈现 Markdown。
* `banner`— 显示启动横幅（`always`或`once``never`）的频率。
* `beep` — 当 Copilot 需要你注意时，发出蜂鸣声。
* `includeCoAuthoredBy` — 向提交添加 `Co-authored-by` 预告片。
* `footer.showBranch` — 在页脚中显示当前 Git 分支。

有关可用设置的完整列表以及用户、存储库和组织设置组合的方式，请参阅 [GitHub Copilot CLI 配置目录](/zh/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference)。

## 延伸阅读

* [配置 GitHub Copilot CLI](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli)
* [关于自定义的概述 GitHub Copilot CLI](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/overview)