52 lines
1.9 KiB
JavaScript
52 lines
1.9 KiB
JavaScript
export const debugGuideResource = {
|
||
uri: "devassistant://resources/debug-guide",
|
||
name: "调试指南",
|
||
description: "常见错误模式和排查方法",
|
||
mimeType: "text/markdown",
|
||
};
|
||
export function getDebugGuide() {
|
||
return `# 调试指南
|
||
|
||
## 调试步骤
|
||
1. **复现问题** — 找到稳定的复现路径
|
||
2. **阅读错误信息** — 仔细看完整报错和堆栈
|
||
3. **缩小范围** — 二分法定位问题代码
|
||
4. **检查假设** — 用 console.log / print 验证变量值
|
||
5. **查看变更** — git diff 看最近改了什么
|
||
6. **搜索已知问题** — Google / StackOverflow / GitHub Issues
|
||
|
||
## 常见错误模式
|
||
|
||
### TypeError: Cannot read properties of undefined
|
||
- **原因**：访问了 null/undefined 的属性
|
||
- **排查**：检查调用链上哪个变量可能为空
|
||
- **修复**：使用可选链 \`?.\` 或提前判空
|
||
|
||
### ECONNREFUSED / ETIMEDOUT
|
||
- **原因**：网络连接被拒绝或超时
|
||
- **排查**：检查目标服务是否启动、端口是否正确、防火墙规则
|
||
- **修复**：确认服务地址和端口，添加重试机制
|
||
|
||
### Memory Leak
|
||
- **表现**：内存持续增长不释放
|
||
- **排查**：检查未清理的定时器、事件监听器、闭包引用
|
||
- **修复**：在组件销毁/函数退出时清理资源
|
||
|
||
### Race Condition
|
||
- **表现**：偶发的数据不一致
|
||
- **排查**：检查并发操作共享状态
|
||
- **修复**：加锁、使用原子操作、或重新设计数据流
|
||
|
||
### Import/Module Error
|
||
- **原因**：路径错误、循环依赖、导出方式不匹配
|
||
- **排查**：检查文件路径、ESM vs CJS、default vs named export
|
||
- **修复**：修正导入路径和方式
|
||
|
||
## 调试工具
|
||
- **Node.js**: \`node --inspect\`, Chrome DevTools
|
||
- **Python**: \`pdb\`, \`ipdb\`, VS Code debugger
|
||
- **浏览器**: Chrome DevTools (Sources, Network, Console)
|
||
- **通用**: \`git bisect\` 定位引入 bug 的提交
|
||
`;
|
||
}
|
||
//# sourceMappingURL=debugGuide.js.map
|