游乐游手机版
首页/AI热点日报/热点详情

重装系统前如何备份GitHub Copilot自定义配置

类型:热点整理2026-06-01
在重装操作系统之前,如果忘记备份 GitHub Copilot 的自定义配置,那无异于执行了一次“硬重置”——包括 ~ copilot 目录下的 settings json、copilot-instructions md、instructions 、skills 等文件夹,以及 VS Code

在重装操作系统之前,如果忘记备份 GitHub Copilot 的自定义配置,那无异于执行了一次“硬重置”——包括 ~/.copilot 目录下的 settings.jsoncopilot-instructions.mdinstructions/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 设置)。打开 VS Code → 左下角齿轮图标 → 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)。这些文件需要和对应的仓库路径严格匹配才能生效,备份时务必保持原样。

来源:https://www.php.cn/faq/2573033.html?uid=1221864

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。