GitHub Copilot重装备份：自定义配置完整保存指南

未在重装系统前备份GitHub Copilot的自定义配置，将直接导致~/.copilot目录下的所有文件（包括settings.json、copilot-instructions.md、instructions/、skills/）以及VS Code中Copilot相关设置完全丢失。系统重装后打开编辑器，所有个性化指令、技能配置、对话历史全部归零，重新配置不仅耗时，且极易遗漏关键项。

重装系统前必须完整保留Copilot的自定义配置，否则重装后个性化设置、指令文件、插件数据、会话历史将全部丢失，事后恢复几乎不可能。

定位Copilot配置根目录

GitHub Copilot CLI的所有用户级配置默认存放在~/.copilot目录下，并非~/.config/copilot或~/.vscode/extensions/。该路径是官方唯一的CLI配置根目录，重装时若只备份VS Code扩展而忽略此目录，自定义指令、技能、权限配置将全部失效。

验证方法：直接执行以下命令：

ls -la ~/.copilot

若返回“no such file or directory”，则表示未使用Copilot CLI，仅通过VS Code插件集成——此时应备份~/.vscode/extensions/github.vscode-copilot-*和~/.vscode/settings.json中所有包含"copilot"字段的配置项。

完整备份~/.copilot目录

这一步必须执行，递归复制整个目录，包括隐藏文件：

cp -r ~/.copilot ~/copilot-cli-backup-$(date +%Y%m%d)

该命令在主目录下生成带日期后缀的备份文件夹，避免多次备份相互覆盖。避免使用cp -r ~/.copilot/* ~/copilot-cli-backup，因为星号会遗漏以点开头的隐藏文件（如.gitignore、.session-store.db），导致恢复时权限异常或会话丢失。

备份完成后验证关键文件是否完整：

ls ~/copilot-cli-backup-*/settings.json copilot-instructions.md instructions/ skills/

导出VS Code中Copilot相关配置（若适用）

提供两种导出方式：

方法一：直接提取settings.json中所有以'copilot'开头的配置项。打开~/.vscode/settings.json，搜索"copilot"，将匹配的完整键值对（包括"github.copilot.enable"、"github.copilot.advanced"、"github.copilot.inlineSuggest.enable"等）复制并另存为copilot-vscode-settings.json。

方法二：使用VS Code内置导出功能（仅针对UI设置）。依次点击：左下角齿轮图标 → Settings → 右上角 {} 图标 → 全选内容 → 复制 → 粘贴到新文件保存为copilot-vscode-settings.json。此方式会导出大量非Copilot设置，需手动删减，否则恢复时可能覆盖其他插件配置。

【警告】严禁直接导出整个settings.json覆盖到新系统——不同VS Code版本字段不兼容，易导致启动失败。

单独备份自定义指令文件

第一步：定位所有.instructions.md文件：

find ~/.copilot -name "*.instructions.md" -type f

第二步：将每个文件单独复制到备份目录，保留原始层级结构。

第三步：重点检查~/.copilot/copilot-instructions.md——全局主指令文件，直接影响所有会话响应风格。确认其编码为UTF-8且无BOM头，否则恢复后CLI会报错。

第四步：进入~/.copilot/instructions/子目录，确认是否存在按项目命名的指令文件（如my-project.instructions.md）。这些文件需与仓库路径严格匹配才能生效，备份时保留原名。

来源：互联网