GitHub_Copilot代码库上下文增强指南：手动指定AI参考文件夹的方法解析

GitHub Copilot默认仅读取当前文件内容，若需精准参考项目中特定模块的代码逻辑，必须手动指定关键文件夹作为上下文源。通过Copilot Spaces添加子文件夹、CLI绑定本地路径或配置指令文件，可实现针对性上下文注入。

使用GitHub Copilot时，要让AI准确参考项目中关键模块（如src/core或docs/api-specs）的代码逻辑，而非仅当前打开的文件内容，必须明确指定该文件夹为上下文源。否则Copilot只会读取光标所在文件，容易生成与项目实际结构不符的代码。

在Copilot Spaces中添加特定文件夹为上下文源

访问指定链接后，点击右上角「Create space」→ 输入空间名称（如"Backend Auth Flow"）→ 选择归属（个人或组织）→ 点击「Create space」。

进入新建空间后，点击「Add source」→ 选择「Add files and repositories」→ 在搜索框中输入目标仓库名称 → 找到后点击进入 → 在文件树中【必须展开到具体文件夹层级】，勾选需要指定的子文件夹（如src/auth），避免勾选根目录或全仓库复选框 → 点击「Confirm selection」。

需要注意的是，Copilot不会一次性加载整个文件夹内容到内存，而是建立索引，在提问时实时检索匹配片段。因此若选择错误的层级（比如仅选择src而未展开至auth），将导致相关代码无法被正确引用。

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

方法一：终端中直接导航至目标文件夹后启动CLI

cd /path/to/your/project/src/auth → copilot → 回车确认信任该路径 → Copilot会立即将此文件夹内所有可读文件纳入本次会话上下文窗口。

方法二：使用--context参数显式声明（适用于需跨目录调用的场景）

copilot --context=/path/to/project/src/auth --context=/path/to/project/shared/utils → 此命令会强制Copilot同时加载两个路径下的内容，但需注意【总上下文令牌数不能超过模型限制，否则早期内容会被自动截断】。

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

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

第二步：在该文件首行写明适用路径，格式为applyTo: src/auth/**/*（支持glob通配符）

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

第四步：提交该文件到远程仓库 → 下次Copilot CLI或Spaces加载此仓库时，只要问题涉及src/auth下任意文件，就会自动注入该指令文件内容作为强约束上下文。

通过上述三种方法，可确保Copilot准确理解项目特定模块的代码逻辑，生成符合实际结构的代码。根据具体使用场景，选择最适合的上下文注入方式，能显著提升AI辅助编程的准确性和效率。