插件崩溃反馈必须包含可复现步骤、Extension host terminated unexpectedly错误行、完整堆栈日志、code --disable-extensions验证结果、启用扩展列表、相关settings配置、VSCode/插件/系统版本及精确触发动作与预期/实际行为对比。

插件故障不能只靠重装或禁用,真正有效的反馈必须让开发者能复现、定位、验证修复——否则大概率石沉大海。
报错信息必须包含 Extension host terminated unexpectedly 这类关键错误行
VSCode 插件崩溃时,控制台(Output 面板 → 选择对应插件名)里出现的完整错误栈才是核心证据。光截图或描述“不工作了”毫无价值。
- 务必复制从
ERR或ERROR开始的整段日志,包括堆栈中所有at ...行 - 如果日志里有
Cannot find module 'xxx',说明依赖缺失,要一并记录node_modules是否存在对应包 - 避免只截取“插件已禁用”这类 UI 层提示——它只是结果,不是原因
必须提供可复现的最小环境配置
开发者不会在你全量项目里调试,他们只会在干净环境里按步骤试。缺这一步,Issue 很可能被直接关闭。
- 确认是否在
code --disable-extensions下问题消失;若否,说明是插件间冲突,需列出所有启用的扩展名(用code --list-extensions输出) - 提供
settings.json中与该插件强相关的配置项,例如"eslint.enable"、"copilot.proxy",而不是整个文件 - 注明 VSCode 版本(
code --version)、操作系统(如Ubuntu 22.04)、插件版本(扩展面板里点插件右下角“…”→“Copy Extension ID and Version”)
别跳过「触发动作」和「预期 vs 实际」的对比描述
很多反馈写成“打开文件就崩”,但实际可能是“在 TypeScript 文件中输入 use 后触发自动补全时崩溃”。差一个动作,根因可能完全不同。
- 用动词明确操作:点击、输入、保存、切换标签页、执行命令(
Ctrl+Shift+P输入什么)、右键菜单选哪项 - 写清楚“应该发生什么”和“实际发生了什么”,例如:
– 应该:按下Tab补全useState
– 实际:Extension host terminated unexpectedly弹出,且Output面板中ESLint日志停止刷新 - 如果问题偶发,注明是否与 CPU/内存压力相关(比如在
top中看到 Node.js 进程占满 CPU)
最常被忽略的是:没验证是否为本地环境特有。比如远程开发时插件失效,要先确认 curl https://api.example.com 在远程服务器终端里能否通——否则反馈里写“Copilot 不工作”,实际只是服务器连不上 API。


















