outputchannel 必须通过 context.subscriptions 管理生命周期，否则卸载后内存驻留、重装堆积；appendline() 自动换行适合日志，append() 不换行易致混杂；结构化日志应使用固定字段顺序的 json 字符串；多插件需用带 id 前缀的唯一通道名防冲突。
OutputChannel 必须用 context.subscriptions 管理生命周期
不加这句，插件卸载后 channel 仍驻留内存，多次重装会堆积多个同名通道，日志混杂甚至崩溃。VS Code 官方文档明确要求所有 OutputChannel 实例必须注册进 context.subscriptions。
常见错误写法：const channel = vscode.window.createOutputChannel('MyExt') 单独声明，没 push。
正确做法：
export function activate(context: vscode.ExtensionContext) {
const outputChannel = vscode.window.createOutputChannel('MyExt');
context.subscriptions.push(outputChannel); // 关键！
// 后续可安全使用 outputChannel.appendLine(...)
}
appendLine() 与 append() 的行为差异直接影响日志可读性
appendLine() 自动换行，适合每条独立日志；append() 不换行，常用于拼接长文本或进度条，但若误用会导致多条日志挤在同一行，排查时极易漏看。
典型踩坑场景：
- 在循环中反复调用
append()写入调试变量，结果所有值连成一串无法分割 - 用
append()输出 JSON 片段，因无换行导致后续appendLine()日志被截断或解析失败
建议：除非明确需要流式输出（如实时进度），否则一律用 appendLine()。
结构化日志必须用 JSON 字符串 + 固定字段顺序
直接拼接字符串如 outputChannel.appendLine(`loss=${loss}, epoch=${epoch}`) 在多人协作或后期接入日志分析工具时几乎无法解析。VS Code 输出面板本身不解析内容，但下游工具（如 grep、jq、自定义脚本）依赖稳定格式。
推荐写法：
outputChannel.appendLine(JSON.stringify({
timestamp: new Date().toISOString(),
level: 'INFO',
epoch,
loss: parseFloat(loss.toFixed(6)),
step
}));
注意三点：
- 时间戳用
toISOString()，避免本地时区干扰 - 数值字段显式转类型（如
parseFloat），防止NaN或undefined进入 JSON - 字段顺序固定，方便正则提取或
jq '.loss'直接取值
多通道命名冲突会导致日志覆盖或不可见
两个插件都调用 vscode.window.createOutputChannel('Debug')，VS Code 会复用第一个创建的通道，第二个插件的日志实际写入了第一个插件的通道——用户切换 Output 面板下拉菜单时根本找不到自己的通道名。
解决方案很简单：
- 通道名带插件 ID 前缀，例如
MyCompany.MyExtension - 避免通用词如
Log、Debug、Output - 发布前检查 marketplace 已有插件的通道命名习惯（可通过 GitHub 搜索
createOutputChannel）
最隐蔽的问题是：开发时只测单插件，上线后与其他插件共存才暴露——这点容易被忽略。
