VS Code Copilot Chat 扩展排障实录

如果依赖和资源都不干净，直接重装更省事：

npm install # 重新安装依赖
git lfs pull # 确保 LFS 资源完整拉取

F5 一按就退

这种情况常见于调试配置本身不对，或者 Watch Mode 比较脆。

处理顺序一般是：

1. 先切到 Launch 扩展，别急着用 Watch Mode
2. 清缓存、重新构建：

npm run clean
npm run build

3. 再确认 VS Code 版本是否兼容，很多人这里会直接上 Insiders，省得跟版本差异缠斗

工具调用没反应

聊天里像 @workspace 这种命令没动静，多半不是 UI 的问题，而是工具注册或 MCP 链路断了。

可以顺着这几个位置看：

1. package.json 里的 contributes.lmTools
2. src/extension/tools/node/
3. src/extension/mcp/

如果工具没注册上，前面看起来都正常，最后也还是不会执行。

需要复现时，用模拟测试

有些问题在本地界面里不太容易稳定复现，直接跑模拟测试更快。

npm run simulate # 运行所有模拟测试
npm run simulate:debug # 调试模式运行模拟测试

结果会落到 test/simulation/baseline.json。实际排查时，最省时间的办法就是拿当前结果和快照对比，看是请求参数变了，还是逻辑分支跑偏了。

断点放哪里更值

要看源码，先从这几个点下断点，通常不会白忙：

• 扩展激活：src/extension/extension/vscode-node/extension.ts 的 activate
• 聊天初始化：src/extension/chat/chat.ts 的 createChatPanel
• 工具调用：src/extension/tools/node/toolNames.ts 的 getTools

测试先跑起来，再谈修

单元测试先看核心功能：

npm run test:unit # 运行核心功能单元测试

测试代码主要在 test/base/：

• test/base/stest.ts：测试框架核心
• test/base/validate.ts：结果验证逻辑

如果要看端到端链路，再跑集成测试：

npm run test:extension # 启动 VS Code 集成测试

覆盖的场景比较典型：

• 聊天会话创建
• 代码生成功能
• 工具调用流程
• 配置变更响应

还可以参考这些文件

• 官方贡献指南：CONTRIBUTING.md
• 工具开发文档：docs/tools.md
• API 变更记录：CHANGELOG.md
• 测试用例库：test/e2e/

这套排查顺序的目的很简单：先把环境和配置问题排掉，再去看激活、日志和工具链路。多数情况下，真正耗时间的不是修复，而是绕着错误路径反复试。把 baseline.json、开发工具控制台和调试视图盯住，基本能把大部分 vscode-copilot-chat 运行问题压到可控范围。