最典型的假性安装是插件显示“已安装”但按钮灰色不可点，根本原因是activationEvents未满足，如插件声明onLanguage:python而当前文件非Python类型；需切换语言模式或新建对应后缀文件触发激活。
插件显示“已安装”但按钮灰色不可点
这是最典型的假性安装——VS Code 认为插件存在，但没触发激活流程。根本原因通常是 activationEvents 未满足，比如插件声明了 onLanguage:python，而你当前打开的是空标签页或 .txt 文件。
解决办法很直接：
- 点击右下角语言模式（如 “Plain Text”），手动切换成插件支持的语言（例如
Python、JavaScript） - 或者新建一个对应后缀的文件（如
test.py），保存后再看插件状态是否变蓝 - 打开命令面板
Ctrl+Shift+P，运行Developer: Toggle Developer Tools，切到Console标签页，刷新窗口，观察是否有Activating extension 'xxx' failed报错 - 在插件市场页面点
ⓘ图标，查看其Activation Events字段，确认你是否满足任一触发条件
插件启用后功能不响应，也没报错
没有错误不等于正常工作。常见原因是配置被覆盖或缺失关键项，尤其当多个同类插件共存时（比如同时装了 esbenp.prettier-vscode 和 esbenp.mdx）。
检查重点如下：
- 运行
Preferences: Open Settings (JSON)，搜索插件名（如@ext:esbenp.prettier-vscode），确认必填字段是否存在：例如prettier.path指向本地 Prettier 可执行文件，eslint.packageManager明确设为"npm"或"pnpm" - 在设置搜索框中输入插件关键词（如
prettier），勾选“显示工作区设置”，对比用户级和工作区级配置是否冲突 - 临时禁用其他格式化/校验类插件（如 ESLint、Stylelint），再逐个启用，定位干扰源
- 注意语言模式匹配：即使文件是
.js，若编辑器右下角显示JavaScript React，而插件只注册了onLanguage:javascript，它也不会生效
中文语言包装了却还是英文界面
中文插件（如 ms-ceintl.vscode-language-pack-zh-hans）只是翻译资源库，不会自动接管 UI。VS Code 是否显示中文，只取决于 locale.json 文件内容和加载时机。
必须走这一步：
- 按
Ctrl+Shift+P打开命令面板，输入并**完整选择**Configure Display Language（不是模糊匹配的其他命令） - 在弹出列表中明确选
zh-cn（不是zh、zh-TW或带括号的选项） - 看到提示后，务必点
Restart—— 仅Developer: Reload Window无效 - 重启后检查
$HOME/.vscode/User/locale.json（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\User\locale.json（Windows），内容应严格为{"locale":"zh-cn"}，多一个空格或逗号都会 fallback 到英文
插件路径迁移后部分功能异常
用 VSCODE_EXTENSIONS 环境变量把插件挪到非系统盘后，常出现中文界面变回英文、某些插件启动失败等问题。这不是路径错了，而是加载顺序被打乱。
核心问题在于：VS Code 启动时先初始化 UI 语言，再加载扩展。如果新路径下的语言包还没来得及注册，UI 就按默认语言渲染了。
应对方式很简单：
- 彻底关闭 VS Code（包括后台进程），再重新打开——第二次启动时插件已预注册，语言包能正常介入
- 确认新路径下确实存在中文包文件夹，名字通常含
zh-hans或ceintl（如ms-ceintl.vscode-language-pack-zh-hans-1.89.0） - 不要手动编辑
locale.json，它必须由 VS Code 自己写入；若被覆盖，删掉它，再运行一次Configure Display Language - 远程开发（SSH/Dev Container）场景下，远程端也要单独执行
Configure Display Language，因为它的locale.json是独立的
插件启用路径本身不复杂，真正容易卡住的是激活条件、配置优先级和加载时序这三个隐性环节。尤其是 locale.json 的生成机制和 activationEvents 的触发逻辑，稍有偏差就静默失效，不报错也不提醒。
