GitHub Copilot代码库上下文增强：手动指定AI参考的特定文件夹

在使用GitHub Copilot时，很多开发者都会遇到这样一个问题：项目中明明有一个独立的src/auth文件夹，里面封装了完整的鉴权逻辑，但只要输入“登录验证”，Copilot就会自动生成一个不存在的verify()函数，完全忽略项目里已有的AuthClient。造成这一问题的根本原因在于：Copilot默认仅以当前打开的单个文件为上下文，无法感知项目其他关键模块的代码结构与逻辑。

因此，若希望Copilot能准确参考项目中的核心模块（例如src/core或docs/api-specs）的代码逻辑，就必须手动将相应的文件夹作为上下文提供给Copilot。以下是几种常见的实现方式。

在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行为的默认规则”——前期配置到位，后续基本无需额外干预。