先确认右下角是否显示Restricted Mode，若是则点击信任工作区并重载；若插件仍无反应，需用code --disable-extensions命令行启动排查是否为插件冲突导致静默崩溃。
插件没反应，先看右下角是不是 Restricted Mode
VSCode 不会报错说“插件被沙盒拦了”，而是直接静默禁用——比如 Markdown Preview Enhanced 点预览没反应、终端里 npm install 报“命令未找到”、launch.json 调试按钮灰掉。这些不是插件坏了，是工作区没被信任，所有扩展能力都被锁死。
检查方式很简单：看窗口右下角有没有锁形图标，显示 Restricted Mode。有就点它 → 选 Trust This Workspace → 勾选 I understand the risks → 点 Trust and Reload。重载后插件立刻恢复，不用改任何设置。
- 这个操作只影响当前文件夹，不影响其他项目
- 本地开发目录（如
D:/Projects/my-app）基本可以放心授信 - 如果每次打开都提示，说明你没点“Trust”，而不是插件配置错了
插件功能异常，检查是否被权限声明机制限制
VSCode 扩展必须在 package.json 里声明权限，比如网络访问、文件读写、调用系统命令。即使你点了信任，插件仍可能因声明不足而无法执行敏感操作——例如一个需要读取 /etc/hosts 的诊断工具，若没声明 "accesses": ["file:///etc"]，就会静默失败。
常见表现：
- Webview 页面加载空白或报
net::ERR_BLOCKED_BY_CLIENT - 插件调用
vscode.env.openExternal打不开链接 - 尝试
fs.readFile本地路径时返回null或抛EPERM
解决方法不是改插件源码，而是确认它是否来自可信来源，并查看其权限请求页面（安装前或扩展详情页里的 “Permissions” 标签）。如果一个语法高亮插件要求 access to all websites，就得警惕。
调试插件崩溃，别信 UI 上的“禁用全部扩展”
点击设置里的“禁用全部扩展”按钮，只是把插件 ID 写进 extensions.disabledExtensions 配置项，但某些插件（如 ms-python.python）会在启动早期就注入代码，禁用逻辑根本来不及生效。
真正干净的排查方式是命令行启动：
- 关掉所有 VSCode 实例
- 终端执行：
code --disable-extensions—— 这会跳过所有插件加载，包括activate()函数和语言服务器 - 如果此时不崩溃，再逐个启用可疑插件：
code --disable-extension esbenp.prettier-vscode --disable-extension dbaeumer.vscode-eslint
注意：--disable-extension 只对本次启动生效，不影响插件本身；崩溃日志藏在 Developer: Open Extension Host Log 里，末尾 ERROR 行常带插件路径，比 UI 提示更准。
Webview 加载失败，检查是否漏开 sandbox 选项
插件里用 WebviewPanel 渲染前端界面时，如果没显式启用 enableScripts 和 localResourceRoots，默认会被隔离——表现为 JS 不执行、CSS 不加载、fetch 报跨域，甚至控制台空空如也。
关键配置项必须写全：
-
enableScripts: true—— 允许运行脚本（默认 false） -
localResourceRoots: [vscode.Uri.file(path.join(context.extensionPath, 'media'))]—— 明确声明可加载的本地资源路径 - HTML 中引用资源必须用
webview.asWebviewUri(uri)转换路径，不能直接写./script.js
漏掉任意一项，Webview 就会卡在白屏或静默失败，且错误不会出现在开发者工具控制台里——得靠 Developer: Toggle Developer Tools 切到 Console 标签，手动刷新 Webview 才能看到 CSP 相关警告。
沙盒不是黑盒，它不隐藏错误，只是把失败变成静默。最常被忽略的是：信任工作区是前提，权限声明是边界，Webview 隔离是默认行为——三者缺一不可，少确认一步，排查就多绕两小时。
