GitHub Copilot上下文路径自定义完整指南：指定外部依赖库提升补全效果
要让GitHub Copilot在代码生成时自动纳入项目中使用的外部库（例如Lodash、React Router或自定义私有SDK），必须显式地将这些路径声明为“可信上下文来源”。默认情况下，Copilot会忽略node_modules、vendor以及第三方SDK目录。配置过程并不复杂，但需要严格遵循以下步骤，否则上下文加载将失败。
定位外部依赖库的准确绝对路径
在项目根目录下执行以下命令之一，验证依赖包的实际存放目录：ls -d node_modules/**/package.json | head -n 3 或 find ./vendor -name "package.json" 2>/dev/null | head -n 3。这一步必须执行，因为Copilot CLI只识别真实存在的路径。若路径拼写错误或使用通配符，后续指令将完全不生效。
记下你要纳入上下文的最外层目录的完整绝对路径，例如 /path/to/my-project/node_modules/lodash 或 /path/to/my-project/vendor/my-internal-sdk。注意：不允许使用 node_modules/* 或相对路径如 ./node_modules/react-router——Copilot CLI要求绝对路径且目标目录必须存在。
创建路径级别的自定义指令文件
在项目根目录下创建文件：.github/instructions/external-deps.instructions.md。
使用任意文本编辑器打开该文件，粘贴以下内容（务必替换 /full/path/to/your/dep 为上一步确认的绝对路径）：
---
applyTo: "/full/path/to/your/dep"
---
When generating code that interacts with this external dependency, always:
- Use its latest stable API as documented in its official TypeScript definitions or source code
- Prefer composition over monkey-patching
- Avoid assuming global variables unless the library explicitly declares them
保存文件。注意：文件名后缀必须为 .instructions.md，且必须位于 .github/instructions/ 目录下。若放置于其他位置（例如 .github/ 根目录或 docs/ 内），Copilot将忽略该指令文件。
启用路径上下文并验证加载状态
首先，确保你安装了Copilot CLI v2.12.0或更高版本。运行 copilot --version 查看当前版本；若版本过低，执行 npm install -g @github/copilot-cli 升级。
然后，在项目根目录下执行：copilot context list。
在输出中查找类似以下条目：✅ /full/path/to/your/dep (from .github/instructions/external-deps.instructions.md)。如果看到带✅前缀且路径完全匹配的行，说明Copilot已成功识别并加载该外部依赖路径。
如果输出为 ❌ No context sources found，或路径显示为 ⚠️ /wrong/path (not found)，请检查以下三项：① 绝对路径是否拼写错误；② 该目录是否存在且非空；③ 文件是否保存为UTF-8编码（Windows记事本的“另存为”默认使用ANSI编码，会导致解析失败）。
最后，运行 copilot chat "How do I debounce a function using the lodash library in this project?"。如果Copilot能够准确引用 _.debounce 并提供包含import语句的完整示例，则说明上下文配置已生效。