vscode-copilot-chat 调试指南：快速解决扩展运行问题

常见问题解决方案

扩展无法激活

症状：VS Code 启动后无 Copilot Chat 界面，扩展列表显示'已停用' 排查步骤：

1. 检查 Node 版本是否符合要求（22.x）：node -v
2. 验证令牌有效性：npm run get_token
3. 查看激活日志：开发工具控制台过滤 activate 关键词

修复命令：

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

调试配置启动失败

症状：F5 启动调试后立即退出，无错误提示 解决方案：

1. 切换调试配置：使用'Launch 扩展'替代 Watch Mode
2. 清理构建缓存：

npm run clean
npm run build

3. 检查 VS Code 版本兼容性，推荐使用 Insiders 版本

工具调用异常

症状：聊天中执行命令（如 @workspace）无响应 排查：

1. 确认工具注册状态：查看 package.json 中的 contributes.lmTools 配置
2. 验证工具实现文件：src/extension/tools/node/
3. 检查 MCP 服务器连接：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/

通过上述工具和方法，可高效定位 90% 以上的 vscode-copilot-chat 运行问题。如遇到复杂场景，建议提交 issue 并附上调试视图截图和开发工具日志。