VS Code 报 command 'extension.xxx' not found 是插件未激活或注册失败所致，常见于重启后首次启动、插件更新中或启用过多插件时，因插件系统懒加载，命令需满足触发条件才注册。
VS Code 报 command 'extension.xxx' not found 是什么情况
这是插件注册失败或未激活的典型表现，不是 VS Code 崩了，也不是你装错了——大概率是插件没加载完，或者被禁用/冲突了。
常见于重启编辑器后首次打开、插件更新中、或同时启用太多插件时。VS Code 的插件系统是懒加载的，package.json 里声明的命令只有在触发条件（比如打开某类文件、执行快捷键）满足时才真正注册。
- 检查插件状态：点左下角齿轮 → Extensions → 找到对应插件，看右上角是否显示 Disabled 或 Reload Required
- 别急着重装：先试
Developer: Reload Window（Ctrl+Shift+P 输入执行），比卸载重装快得多 - 排除冲突：临时禁用其他插件（尤其是同类型 LSP 或语法高亮插件），再试原命令
- 留意输出面板：
Output下拉选对应插件名，常能看到Cannot find module或Activation failed这类真实报错
终端里弹出 zsh: command not found: code 怎么办
这不是 VS Code 本身的问题，是你没把 code 命令加进 shell 的 PATH。Mac 和 Linux 默认不自动配置，Windows 的 PowerShell 也一样。
本质是 VS Code 没法告诉你的 shell “我在哪”，所以你在终端敲 code . 才会失败。它和图形界面启动完全无关，只影响命令行调用。
- Mac：打开 VS Code →
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - Linux：同上操作，但需确保已安装 VS Code 的 .deb/.rpm 包（AppImage 不支持该命令）
- Windows：用 VS Code 自带的终端（
Ctrl+`）没问题；若要在 Windows Terminal 或 CMD 里用，得勾选安装时的 Add to PATH 选项（重装时注意勾选） - 手动补救（不推荐）：把
/Applications/Visual Studio Code.app/Contents/Resources/app/bin（Mac）或对应安装路径加进~/.zshrc，但容易出路径权限或空格问题
保存文件时突然弹 Unable to write file ... NoPermissions (FileSystemError)
VS Code 没有静默降级权限，它严格按操作系统返回的错误码报错。出现这个提示，说明它真的没权限写入目标位置，不是缓存或 UI 假死。
最常见于用 sudo code /etc/hosts 启动后又试图保存非 root 文件，或者项目目录属主被意外改掉（比如用 sudo npm install 导致 node_modules 下一堆 root 所有者）。
- 别硬点“Retry”：重复点击只会反复报错，不会自动提权
- 查归属：终端里运行
ls -ld /path/to/dir，确认当前用户对父目录有w权限 - 别用 sudo 启动 VS Code：这是最大误区。正确做法是用普通用户启动，需要改系统文件时，保存前复制内容到终端用
sudo tee写入 - WSL 用户注意：挂载点如
/mnt/c/xxx默认是只读或无 Unix 权限映射，改/etc/wsl.conf加metadata=true并重启 WSL
扩展弹窗说 This extension is not compatible with the current version of VS Code
不是所有扩展都会实时适配新版本 VS Code。VS Code 自身升级快，但有些扩展作者维护慢，或依赖已废弃的 API（比如旧版 vscode.workspace.rootPath 已被 vscode.workspace.workspaceFolders 替代）。
兼容性声明写在扩展的 package.json 里，VS Code 启动时就校验，不满足直接禁用，连激活逻辑都不会跑。
- 看扩展详情页的 Compatibility 栏：明确写了支持哪些 VS Code 版本范围（如
^1.70.0） - 别降级 VS Code：风险远大于收益；优先找替代扩展（比如
ESLint插件已弃用，换eslint官方新版） - 开发者可临时绕过：在
settings.json加"extensions.ignoreRecommendations": true，但无法解决根本兼容问题 - 企业环境特别注意：如果用的是 VS Code Insiders 或自建发行版，扩展市场默认屏蔽非稳定版兼容项，需手动开启
extensions.showRecommendationsOnlyOnDemand
权限、路径、兼容性这三类弹窗背后，其实都是 VS Code 在严格执行规则——它不猜你想干嘛，只告诉你“我做不到，因为系统/配置/代码不让我做”。看清报错里的那个 code 片段，比盲目重启管用得多。
