{"meta":{"title":"使用 /settings 命令更改设置","intro":"使用GitHub Copilot CLI斜杠命令查看和更改/settings的个人设置。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/how-tos","title":"操作方法"},{"href":"/zh/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/zh/copilot/how-tos/copilot-cli/customize-copilot","title":"自定义 Copilot CLI"},{"href":"/zh/copilot/how-tos/copilot-cli/customize-copilot/change-settings","title":"更改设置"}],"documentType":"article"},"body":"# 使用 `/settings` 命令更改设置\n\n使用GitHub Copilot CLI斜杠命令查看和更改/settings的个人设置。\n\n可以使用 `/settings` 斜杠命令在交互式 CLI 会话中查看和更改设置。 此命令控制用户级设置，例如是否 Copilot CLI 自动更新自身、界面使用的调色板、页脚中显示的内容和其他许多选项。\n\n使用 `/settings` 来：\n\n* **以交互方式浏览和编辑设置** - 自行运行 `/settings` 以打开可搜索编辑器，其中列出了每个设置及其当前值。\n* **使用单个命令更改设置** - 运行 `/settings KEY VALUE` 以更改特定设置而不打开编辑器。\n* **检查设置的值** - 运行 `/settings show KEY` 以显示设置的当前值。\n\n你也可以使用 `/config`，它是 `/settings` 的别名。\n\n使用 `/settings` 或 `/config` 所做的更改会写入你的个人设置文件（默认为 `~/.copilot/settings.json`），并在不同会话之间持续保留。\n\n## 打开设置编辑器\n\n若要以交互方式浏览和编辑设置，请输入不带参数的斜杠命令：\n\n```copilot copy\n/settings\n```\n\n编辑器列出了可以更改的每个设置，以及设置的当前值。 在列表中向上或向下移动时，编辑器底部会显示突出显示的设置的简短说明。 这样就可以浏览和编辑设置，而无需知道其确切名称。\n\n有关可用设置的详细信息，请参阅 [GitHub Copilot CLI 配置目录](/zh/copilot/reference/copilot-cli-reference/cli-config-dir-reference#user-settings-copilotsettingsjson)。\n\n当编辑器打开时，可以使用以下键盘快捷方式：\n\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
关键Action
\n→ / 在设置之间移动。
/按设置的名称或说明搜索和筛选列表。
\n输入切换布尔型设置，或编辑其他类型的值。
\nCtrl+R将突出显示的设置重置为其默认值。
\nCtrl+E在配置的终端编辑器中打开 settings.json ，进行高级更改。
\nEsc清除当前搜索，或关闭编辑器。
\n\n大多数更改都会立即生效，例如，选择新值后，切换调色板会立即更新界面。\n\n## 直接更改单个设置项\n\n如果已知道要更改的设置，可以直接从 CLI 的提示框中设置此设置，而无需打开编辑器：\n\n```copilot\n/settings KEY VALUE\n```\n\n例如：\n\n```copilot copy\n/settings autoUpdate off\n```\n\nCopilot 写入值并确认该值，例如： `Set autoUpdate = false.`\n\n> \\[!NOTE]\n> \\*\n> **布尔设置**可接受`on`/`off`或`true`/`false`。 例如，`/settings renderMarkdown on`。\n> \\*\n> **具有固定选项集的设置** 接受其中一个值。 例如，`/settings theme dim` 或 `/settings banner never`。\n> \\*\n> **嵌套设置** 使用虚线路径。 例如， `/settings footer.showBranch off` 隐藏页脚中的 Git 分支。\n\n只需使用导航和 Enter 键即可配置采用设置值的设置，而无需记住确切的键或值。 例如，若要防止代理提出澄清问题，请执行以下操作：\n\n1. 键入 `/settings`，不按 Enter 可显示选项列表。\n2. 使用 ↓ 键在列表中向下移动，直到 `❯` 指向 `/settings askUser Allow the agent to ask clarifying questions`，然后按 Enter。\n3. 使用 ↓ 键在此设置的选项列表中向下移动，直到 `❯` 指向 `/settings askUser off`，然后按 Enter。\n4. 再次按 Enter 以提交 `/settings askUser off` 命令。\n\n CLI 确认更改： `Set askUser = false.`\n\n## 查看设置的有效值\n\n若要显示某项设置可用的有效值，请输入不带值的 `/settings KEY`。 例如，若要查看 `theme` 的有效值：\n\n```copilot copy\n/settings theme\n```\n\n## 查看设置的当前值\n\n若要显示设置的当前值，请使用 `show`。 例如：\n\n```copilot copy\n/settings show theme\n```\n\n这会输出一行，例如 `theme = high-contrast`。 此 `show` 表单可用于快速检查值或捕获日志中的设置。\n\n## 更改需要重启的设置\n\n大多数设置会立即生效，但有些设置只有在 Copilot CLI 重启后才会完全生效，例如 `experimental` 和代理设置。 更改其中一项时， Copilot 告知需要重启，并可能为你重启会话。\n\n## 无法从命令行更改的设置\n\n并非每个设置都可以通过内联 `/settings KEY VALUE` 方法进行编辑：\n\n* **安全敏感设置**（例如更改凭据存储方式或运行 shell 命令的设置）被故意排除，因为将其翻转为一行且没有确认是有风险的。\n* **列表和结构化设置**无法以内联方式设置。 按 `/settings`Ctrl+E 在配置的终端编辑器中打开 `settings.json` ，然后编辑该设置。\n* **存储库或组织管理的设置** 会显示供参考，但其值来自这些源并替代你的个人值。 在用户设置中更改它们不起作用。\n\n在每种情况下， Copilot 都会解释为何未应用更改，并将你指向正确的位置进行更改。\n\n## 被 `/settings` 替换的命令\n\n一些较旧的斜杠命令已并入 `/settings`。 它们仍然可用，但会显示一则提示，告诉你与之等效的 `/settings` 命令。\n\n## 可能需要更改的设置\n\n一些常用的设置包括：\n\n* `autoUpdate` — 自动更新更新的 CLI 版本。\n* `theme`— 调色板（`default`、、`github``dim`、`high-contrast`或`colorblind`）。\n* `renderMarkdown` — 在终端中呈现 Markdown。\n* `banner`— 显示启动横幅（`always`或`once``never`）的频率。\n* `beep` — 当 Copilot 需要你注意时，发出蜂鸣声。\n* `includeCoAuthoredBy` — 向提交添加 `Co-authored-by` 预告片。\n* `footer.showBranch` — 在页脚中显示当前 Git 分支。\n\n有关可用设置的完整列表以及用户、存储库和组织设置组合的方式，请参阅 [GitHub Copilot CLI 配置目录](/zh/copilot/reference/copilot-cli-reference/cli-config-dir-reference)。\n\n## 延伸阅读\n\n* [配置 GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli)\n* [关于自定义的概述 GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli/customize-copilot/overview)"}