GitHub Copilot上下文增强：手动指定文件夹教程

使用GitHub Copilot的开发者常遇到这样的困境：项目中明明有专用的src/auth目录，封装了完整的身份验证逻辑，但一旦提及"登录校验"，Copilot就开始自行推导——下一行凭空生成一个虚构的verify()函数，完全无视项目里已有的AuthClient。根本原因很简单：Copilot默认仅解析当前打开的文件，对项目其他关键模块的上下文毫无察觉。

要让Copilot真正将项目核心模块（例如src/core或docs/api-specs）的代码逻辑作为参考依据，必须手动将该文件夹作为上下文"喂"给它。下面介绍几种可行的实现路径。

在Copilot Spaces中指定文件夹作为上下文来源

这是最简洁且运维成本最低的方案，尤其适合团队协作或长期迭代的项目。

进入Copilot Spaces入口页面，点击右上角「Create space」→ 为空间命名，例如"Backend Auth Flow"→ 选择归属（个人或组织）→ 确认创建。

空间创建成功后，点击「Add source」→ 选择「Add files and repositories」→ 在搜索框中输入项目仓库名称 → 找到后进入 → **务必展开至具体文件夹层级**，例如定位到src/auth，仅勾选该子文件夹，切勿直接勾选根目录或整个仓库。确认无误后点击「Confirm selection」即可生效。

常见踩坑点：Copilot不会将整个文件夹内容一次性加载进内存——它只会在后台建立索引，在你提问时实时检索匹配。如果仅选择了src而未进一步展开到src/auth，那么鉴权相关代码依然很难被命中。

通过CLI会话临时绑定本地文件夹

此方式更适合临时性或调试场景，灵活性高，但需通过命令行操作。

方法一：在终端中cd到目标文件夹，然后输入copilot启动会话，回车确认信任该路径。Copilot随即将该文件夹内所有可读文件纳入当前会话的上下文。

方法二：使用--context参数显式声明。例如同时加载两个不同路径的模块：

copilot --context=/path/to/project/src/auth --context=/path/to/project/shared/utils

该命令强制Copilot将两个路径同时纳入上下文。但需注意硬性约束——**总上下文令牌数不能超过模型限制**，否则最早加载的内容会被自动截断，功亏一篑。

配置仓库级指令文件并关联路径规则

本质上相当于为Copilot编写一份"项目规则手册"，适合需要统一团队编码规范的中大型项目。

第一步：在项目根目录下创建.github/instructions/auth-module.instructions.md。

第二步：文件开头注明适用路径，格式为applyTo: src/auth/**/*（支持glob语法，灵活度很高）。

第三步：撰写具体约束。例如："所有鉴权逻辑必须调用AuthClient.verifyToken()，禁止自行实现JWT解析；返回错误统一使用AuthError枚举类。"

第四步：将文件提交到远程仓库。此后只要Copilot CLI或Spaces加载该仓库并遇到src/auth下的文件，指令文件会自动注入，作为硬性约束指导代码生成。

从实际效果来看，指令文件的方式最接近"让团队约定成为AI行为的默认规则"——前期配置到位，后续几乎无需干预。

来源：互联网