1. 为什么 Copilot 总是“答非所问”
用 GitHub Copilot 写代码的人，大概率都经历过这种落差：你只是想让它补一个带参数校验的工具函数，它却热情地甩给你三十行实现，里面还夹着两个魔法数字和一个没处理的空值分支。代码能跑，但离“能进代码库”还差一次彻底的重构。
这个问题的根源不在模型能力，而在指令的传递方式。Copilot 默认只拿到你当前打开的文件、光标附近的上下文，以及你敲下的那几行注释。它不知道你们团队禁止any、不知道错误要统一抛自定义异常、不知道这个项目用的是函数式风格而不是 class。信息缺失，它只能按训练数据里的“平均写法”来猜，猜出来的自然就是那种“能跑但让资深工程师皱眉”的代码。
我试过在注释里写一长串要求，结果发现每次新开一个文件就得重写一遍，而且 Copilot 对注释里的长指令遵循度并不稳定。真正可复用的做法，是把这些约束沉淀到 VS Code 的settings.json里，通过github.copilot.chat.codeGeneration.instructions这个配置项，把指令以文件或内联文本的形式喂给 Copilot。这样无论你打开哪个文件、哪个项目，只要工作区加载了这份配置，Copilot 就会带着你的规范去生成代码。
这篇内容面向的是已经在用 Copilot、但被输出质量不稳定困扰的开发者。我会给出一份可以直接复制的settings.json骨架，逐项解释每个字段的作用，然后带你走一遍“改配置 → 重启 → 验证指令是否生效”的完整动作。整套流程不依赖任何特殊网络环境，纯本地配置。
2. 前置准备：TaoToken 与 Copilot 的配合位置
在动手改配置之前，先把工具链的位置理清楚。GitHub Copilot 负责在编辑器里做代码补全和对话，而 TaoToken 提供的是模型侧的 API 接入能力。两者不是替代关系：Copilot 是你在 VS Code 里的交互入口，TaoToken 是你调用模型能力时的统一网关。
如果你只是想让 Copilot 遵循指令，那这一章可以快速过一遍，直接跳到第 3 章的配置骨架。但如果你希望把“指令遵循”这套思路延伸到 Copilot 之外的场景——比如自己写脚本批量生成代码、或者在 CI 里做代码规范检查——那就需要先拿到一个可用的 API Key。
获取路径很直接：打开 https://taotoken.net/api-keys ，登录后在控制台创建密钥。这个 Key 后面会用在自定义脚本或第三方工具里，格式通常是sk-开头的一串字符。创建完先复制保存，页面刷新后就看不到了。
拿到 Key 之后，接入文档在 https://taotoken.net/doc ，里面列了不同语言和工具的调用方式。如果你打算用 Claude Code 这类命令行工具做长期编码，可以看 https://taotoken.net/coding-plan 里的套餐说明；如果只是想先验证模型对话效果，https://taotoken.net/chat 可以直接在浏览器里试。
这里要强调一点：Copilot 本身的配置和 TaoToken 的 Key 是两条线。Copilot 的settings.json管的是“生成时带什么指令”，TaoToken 的 Key 管的是“调用模型时走哪个通道”。两者可以独立使用，也可以组合——比如你用 TaoToken 的 API 写了一个代码审查脚本，脚本里读取的规范文件，和 Copilot 用的是同一份。这样规范和执行就统一了。
3. 可复制的 settings.json 配置骨架
VS Code 的settings.json分两层：用户级（全局生效）和工作区级（只对当前项目生效）。指令遵循这种强项目相关的事情，建议放在工作区级的.vscode/settings.json里，跟着仓库走，团队每个人拉下来就生效。
下面这份骨架可以直接复制。我把它拆成“内联指令”和“文件指令”两部分，内联的适合放短小通用的约束，文件的适合放成体系的规范。
{ "github.copilot.chat.codeGeneration.instructions": [ { "text": "始终使用 TypeScript 严格模式，禁止出现 any 类型。如果无法推断类型，使用 unknown 并做类型收窄。" }, { "text": "所有异步函数必须处理错误，禁止空的 catch 块。错误统一抛出 new AppError(message, code)。" }, { "text": "函数参数超过 3 个时，必须改为接收一个 options 对象，并对每个字段做校验。" }, { "file": ".github/instructions/code-standards.md" }, { "file": ".github/instructions/testing-guidelines.md" }, { "file": ".github/instructions/error-handling.md" } ], "github.copilot.chat.codeGeneration.useInstructionFiles": true }逐项说明一下。text字段是直接写死在配置里的指令，适合那种一句话就能说清、且所有项目都通用的规则。比如“禁止 any”这条，几乎适用于所有 TS 项目，放内联最省事。
file字段指向的是 Markdown 文件，路径相对于工作区根目录。这种适合成体系的规范，比如代码标准、测试指南、错误处理约定。文件内容会被 Copilot 读取并作为生成时的上下文。注意路径别写错，写错了 Copilot 不会报错，只是静默忽略，你会以为配置生效了其实没有。
useInstructionFiles这个开关要设为true，否则file字段可能不生效。这个配置项在不同 VS Code 版本里行为略有差异，建议保持 VS Code 和 Copilot 插件都是较新版本。
那三个 Markdown 文件里写什么？给你一个code-standards.md的最小示例：
# 代码标准 ## 命名 - 变量和函数用 camelCase，类型和接口用 PascalCase，常量用 UPPER_SNAKE_CASE。 - 布尔变量以 is/has/can 开头，禁止用 flag、temp 这类无意义命名。 ## 函数 - 单个函数不超过 40 行，超过就拆分。 - 禁止副作用隐藏在 getter 里，getter 只做读取。 ## 注释 - 只对“为什么这么做”写注释，不写“做了什么”。 - 公开 API 必须有 JSDoc，包含 @param 和 @returns。testing-guidelines.md里可以写测试命名规范、必须覆盖的边界情况、mock 的使用原则。error-handling.md里写错误码分段、日志格式、重试策略。这些文件不需要一次写全，先写最痛的三条，跑一段时间再补。
配置改完后，VS Code 不会自动重载。你需要按Ctrl+Shift+P（Mac 是Cmd+Shift+P）打开命令面板，执行Developer: Reload Window。这一步很关键，很多人改完配置发现没效果，就是因为没重载。
4. 验证指令是否真正生效
配置写完、窗口重载之后，怎么确认 Copilot 真的读到了这些指令？不能靠感觉，得用可复现的测试动作。
第一个验证动作：新建一个.ts文件，输入下面这行注释，然后回车让 Copilot 补全。
// 写一个函数，接收用户对象，返回格式化后的显示名如果指令生效，Copilot 生成的代码应该满足几个特征：参数有明确类型而不是any；如果参数超过三个会改成 options 对象；函数体不会超过 40 行；命名符合 camelCase。你可以对照code-standards.md里的条目逐条检查。
第二个验证动作：故意触发一个错误处理场景。输入：
// 从 API 获取用户列表，出错时返回空数组观察 Copilot 是直接try { ... } catch { return [] }还是按error-handling.md里的约定抛出AppError。如果它还是用空 catch，说明文件指令没被读到，回去检查file路径和useInstructionFiles开关。
第三个验证动作更直接：打开 Copilot Chat 面板，输入@workspace 列出当前生效的代码生成指令。较新版本的 Copilot 会把加载到的指令内容列出来。如果列表里没有你写的文件，那就是路径问题。
实测下来，最容易踩的坑是文件路径。.github/instructions/code-standards.md这个路径是相对于工作区根目录的，不是相对于.vscode目录。如果你把文件放在.vscode/instructions/下，路径就要写成.vscode/instructions/code-standards.md。另外文件名不要用中文或空格，虽然理论上支持，但实际解析时容易出问题。
验证通过后，你会明显感觉到 Copilot 的输出“收敛”了。它不再动不动给你三十行，而是按你的规范来。这时候可以把这套配置提交到仓库，团队其他人拉下来重载窗口就能用同一套规范。
5. 本篇常见错排查
配置过程中有几个高频报错和“看起来没报错但就是不生效”的情况，集中说一下。
问题一：改了 settings.json 但 Copilot 行为没变化。九成是没重载窗口。VS Code 对settings.json的监听不是实时的，尤其是github.copilot.chat.codeGeneration.instructions这种数组配置。养成改完就Developer: Reload Window的习惯。
问题二：file指向的文件明明存在，但指令没加载。先检查useInstructionFiles是否为true。再检查路径大小写，Linux 和 macOS 默认大小写敏感，Code-Standards.md和code-standards.md是两个文件。最后检查文件编码，必须是 UTF-8，带 BOM 的文件在某些版本里解析会出问题。
问题三：指令太多导致 Copilot 响应变慢或开始“遗忘”前面的规则。这是上下文窗口的物理限制。指令不是越多越好，建议内联指令控制在 5 条以内，文件指令控制在 3 个文件以内，每个文件不超过 200 行。把最核心的约束放前面，次要的往后排。如果确实需要大量规范，考虑拆成多个工作区配置，按项目类型加载不同的指令集。
问题四：Copilot 生成的代码部分遵循指令，部分不遵循。这通常是因为指令之间有冲突。比如你既要求“函数不超过 40 行”，又要求“所有逻辑写在一个函数里”，Copilot 只能二选一。排查方法是把指令逐条注释掉，二分定位冲突项。
问题五：想用 TaoToken 的 API 做批量代码生成，但返回结果不符合规范。这种情况要把指令作为 system prompt 的一部分传进去，而不是只放在用户消息里。接入文档 https://taotoken.net/doc 里有 system prompt 的传参示例。另外注意，API 调用和 Copilot 插件是两套独立的指令体系，你在settings.json里写的指令不会自动同步到 API 调用里，需要手动维护一份共享的规范文件，两边都引用。
6. 把指令遵循变成可复用流程
配置骨架跑通之后，真正有价值的是把它变成团队可复用的流程。我的做法是在仓库里建一个.github/instructions/目录，把规范文件放进去，然后在.vscode/settings.json里引用。新项目初始化时，直接把这个目录和配置复制过去，改改项目特定的部分就能用。
如果你想把这套规范延伸到 Copilot 之外的场景，比如用脚本做提交前的代码检查，可以拿 TaoToken 的 API Key 写一个简单的校验脚本。Key 在 https://taotoken.net/api-keys 创建，调用方式参考 https://taotoken.net/doc 。脚本里读取同一份code-standards.md，把规范作为 system prompt 传给模型，对 diff 做审查。这样 Copilot 在写代码时遵循规范，脚本在提交时检查规范，两头对齐。
需要长期在命令行里做编码和 Agent 任务的，可以看 https://taotoken.net/coding-plan 里的方案，把模型调用和本地工具链串起来。想先快速验证模型对某段指令的遵循效果，https://taotoken.net/chat 可以直接对话测试，不用写代码。
整套流程的核心就一句话：把“你希望 AI 怎么做”从每次临时敲的注释，变成仓库里版本化的配置文件。配置一次，长期生效，团队共享。这比每次在注释里写小作文靠谱得多。
