vscode插件日志需用vscode.window.createoutputchannel而非console.log；激活错误须try/catch并console.error；调试日志应通过配置项动态开关；output日志需加时间戳和请求id以保上下文。
调试日志没输出？检查 console.log 是否被拦截
VSCode 插件运行在 Node.js 环境（Extension Host 进程），但默认不把 console.log 输出到开发者工具控制台——它会被静默丢弃。你看到空白，并不是代码没执行，而是日志通道没打通。
正确做法是调用 VSCode 提供的专用日志接口：vscode.window.showInformationMessage 用于简单提示，更推荐用 vscode.window.createOutputChannel 创建专属输出通道：
const output = vscode.window.createOutputChannel('My Extension');
output.appendLine('Loading config...');
output.show(); // 必须调用 show() 才能在 OUTPUT 面板看到
常见错误：只写 console.log 却没切换到 OUTPUT 面板（快捷键 Ctrl+Shift+U / Cmd+Shift+U），或忘记调用 .show()。
如何捕获插件启动失败时的错误堆栈？
插件激活函数（activate）抛出未捕获异常时，VSCode 不会弹窗，也不会输出到 OUTPUT，仅在「开发者工具」控制台显示 Activating extension 'xxx' failed，但堆栈被截断。
必须手动包裹 activate 并打印完整错误：
export function activate(context: vscode.ExtensionContext) {
try {
// 你的初始化逻辑
} catch (err) {
console.error('Activation error:', err); // 这行会在开发者工具中显示完整堆栈
throw err;
}
}
注意：console.error 在 Extension Host 中有效，且比 console.log 更可能触发开发者工具的错误高亮；不要依赖 try/catch 后静默吞掉错误。
调试时日志太多？用 vscode.workspace.getConfiguration 控制开关
上线后不能留一堆 output.appendLine，但开发时又需要细粒度日志。直接硬编码开关容易遗忘，推荐读取配置项动态控制：
- 在
package.json的contributes.configuration中声明："myExtension.debugLogging": { "type": "boolean", "default": false, "description": "Enable detailed debug logs" } - 在代码中检查：
vscode.workspace.getConfiguration().get('myExtension.debugLogging') - 封装一个安全日志函数：
function debugLog(msg: string) { if (vscode.workspace.getConfiguration().get('myExtension.debugLogging')) { output.appendLine(`[DEBUG] ${msg}`); } }
这样用户可在设置里搜 myExtension.debugLogging 实时开关，无需改代码、重载插件。
OUTPUT 面板日志消失太快？别只靠 appendLine
output.appendLine 写入后，如果插件快速退出或 VSCode 重启，日志就没了。临时调试可以，但分析异步链路（比如命令触发 → API 调用 → 响应处理）时极易丢失上下文。
更可靠的做法是：结合时间戳 + 唯一请求 ID 记录关键节点：
const reqId = Math.random().toString(36).substr(2, 6);
output.appendLine(`[${new Date().toISOString()}][${reqId}] Starting fetch`);
// ... 处理中
output.appendLine(`[${new Date().toISOString()}][${reqId}] Got response: 200`);
避免使用 console.time —— 它在 Extension Host 中行为不稳定；也不要用 process.uptime()，因为插件进程可能被热重载中断重置。
真正难的是跨进程日志对齐（比如 Webview 和 Extension Host 通信），那得额外约定消息格式并统一打到同一个 OutputChannel，否则根本串不起来。
