使用 /settings 命令更改设置

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

在本文中

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

使用 /settings 来：

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

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

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

打开设置编辑器

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

Copilot prompt
/settings

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

有关可用设置的详细信息，请参阅 GitHub Copilot CLI 配置目录。

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

关键Action
↑ / ↓在设置之间移动。
/按设置的名称或说明搜索和筛选列表。
输入切换布尔型设置，或编辑其他类型的值。
Ctrl+R将突出显示的设置重置为其默认值。
Ctrl+E在配置的终端编辑器中打开 settings.json ，进行高级更改。
Esc清除当前搜索，或关闭编辑器。

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

直接更改单个设置项

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

/settings KEY VALUE

例如：

Copilot prompt
/settings autoUpdate off

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

注意

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

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

  1. 键入 /settings，不按 Enter 可显示选项列表。

  2. 使用 ↓ 键在列表中向下移动，直到 ❯ 指向 /settings askUser Allow the agent to ask clarifying questions，然后按 Enter。

  3. 使用 ↓ 键在此设置的选项列表中向下移动，直到 ❯ 指向 /settings askUser off，然后按 Enter。

  4. 再次按 Enter 以提交 /settings askUser off 命令。

    CLI 确认更改： Set askUser = false.

查看设置的有效值

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

Copilot prompt
/settings theme

查看设置的当前值

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

Copilot prompt
/settings show theme

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

更改需要重启的设置

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

无法从命令行更改的设置

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

  • 安全敏感设置（例如更改凭据存储方式或运行 shell 命令的设置）被故意排除，因为将其翻转为一行且没有确认是有风险的。
  • 列表和结构化设置无法以内联方式设置。 按 /settingsCtrl+E 在配置的终端编辑器中打开 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 配置目录。

延伸阅读