GitHub Copilot的配置文件究竟存放在哪里?这个问题看似简单,但如果不仔细了解,很容易陷入误区。无论是Windows还是Mac,其配置目录都固定为~/.copilot,Windows对应C:\Users\你的用户名\.copilot,Mac对应/Users/你的用户名/.copilot。首次运行copilot命令后,该目录会自动创建,其中包含config.json等核心文件。

若要修改Copilot CLI的行为或添加自定义说明,首要任务是精确找到其配置文件在本地磁盘的具体位置——否则任何编辑操作都无从谈起。
Windows系统下查找Copilot配置目录的方法
在Windows平台上,过程稍显曲折。打开PowerShell,先尝试执行以下命令:
Get-AppxPackage -Name "GitHub.Copilot" | Select-Object InstallLocation
如果返回空结果,说明您的Copilot CLI是通过winget独立安装的,而非AppX包。此时直接运行where copilot,您会看到类似 C:\Users\Alice\AppData\Local\Microsoft\WindowsApps\copilot.exe 的路径,可执行文件即位于该处。
但这里有一个关键要点:可执行文件所在目录(即 %LOCALAPPDATA%\Microsoft\WindowsApps)本身并不存放配置数据。真正的配置根目录始终固定在 ~/.copilot,对应Windows上的 C:\Users\你的用户名\.copilot。该路径是硬编码的,不会随安装方式变化而改变。
需要特别提醒:切勿在 WindowsApps 目录中徒劳寻找 config.json——它根本不在那里。这是一个常见的误解,特此强调。
Mac系统中定位Copilot配置目录的方法
在Mac上则更为简便。打开终端,执行以下命令:ls -la ~/.copilot
如果系统提示“No such file or directory”,表示您尚未启动过Copilot CLI的交互会话,配置目录尚未生成。此时只需运行一次 copilot 命令,按照提示完成登录及信任目录的步骤,~/.copilot 目录及其内部的 config.json、copilot-instructions.md 等文件便会自动创建。
Mac系统不存在路径混淆问题:无论您是通过Homebrew安装、使用GitHub官方的pkg包安装,还是手动解压CLI,配置目录始终是用户主目录下的 .copilot 隐藏文件夹。
确认并进入配置目录的通用方法
无论您使用Windows还是Mac,按照以下三个步骤即可顺利完成:
第一步:在终端中运行 copilot version,确保CLI已正确安装并可正常调用。
第二步:执行 cd ~/.copilot——若提示目录不存在,立即执行一次 copilot 命令启动交互会话(在任何目录下均可,按提示选择 Yes),退出后再执行 cd ~/.copilot。
第三步:执行 ls -la(Mac)或 dir /a(Windows PowerShell),确认可以看到 config.json、copilot-instructions.md 和 permissions-config.json 这几个核心文件。
这几步操作起来很简单,将所需文件拖入目录即可。但有一点需要特别留意:请确保当前 shell 用户与安装 Copilot CLI 的用户一致——切换用户后,~/.copilot 目录会完全不可见。这个问题容易被忽视,若遇到配置找不到的情况,建议首先检查用户身份是否一致。
