执行 code --version 查看真实版本号，如1.102.3；主流插件要求≥1.68.0，但1.104.0等新版可能因语义化版本限制（如"^1.103.0"不匹配1.104.0）导致不兼容。
怎么看当前 VS Code 是不是太老或太新
直接执行 code --version，输出如 1.102.3 就是真实版本号。Fitten Code 等主流插件要求 ≥1.68.0；但如果你用的是 1.104.0 这类刚发布的版本，部分插件可能还没适配——它们的 package.json 里写的是 "vscode": "^1.103.0"，而 ^1.103.0 不匹配 1.104.0（语义化版本规则限制）。别只看“数字更大就一定兼容”，新版也可能被拒。
插件报 “not compatible with VS Code '1.xxx'” 怎么快速修
这不是网络或权限问题，是 VS Code 启动时硬校验 engines.vscode 字段失败，连日志都不进。必须改 .vsix 文件：
- 用
7-Zip（Windows）、unzip（Linux/macOS）打开下载好的ms-ceintl.vscode-language-pack-zh-hans-*.vsix - 进入
extension/package.json（注意：不是根目录那个！） - 把
"vscode": "^1.103.0"改成"vscode": ">=1.85.0"（推荐，兼容宽）或"vscode": "^1.102.0"（若你本地是1.102.3） - 保存后重新打包为
zip，再把后缀名改回.vsix - 命令面板运行
Extensions: Install from VSIX安装这个改过的文件
装完还是英文？重点检查 locale.json 是否被绕过
VS Code 不靠插件自动切语言，它只读 locale.json。即使插件已启用、版本也对得上，只要这个文件不存在、值写错、或被更高优先级配置覆盖，界面就一定是英文。
- 路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容只能是：
{"locale": "zh-hans"}（不是zh-CN，写错就报invalid locale value） - 文件不存在？手动创建；存在但值是
"en"？直接改掉并保存 - 改完必须完全退出 VS Code（包括托盘进程），再重启
Remote-SSH 或 Python 插件失效，先核对远端与本地版本是否一致
Remote-SSH 不是纯前端插件，它会在远端自动部署 vscode-server。如果本地是 1.102.3，远端却拉了 1.103.0 的 server，就会卡在 Starting VS Code Server。Python 插件同理：Pylance、debugpy、python.exe 解释器三者版本不齐，import 就会静默失败。
- 远程机器上执行：
rm -rf ~/.vscode-server，再重连，触发重下匹配版本 - 本地终端运行
python -c "import sys; print(sys.executable)"，和右下角解释器提示路径比对，必须完全一致 - 集成终端里执行
pip --version，确保显示的 Python 路径和上面一致；不一致就用python -m pip install xxx
真正卡住人的，往往不是“不会装”，而是改了 package.json 却误改了外层根目录的文件，或是删了缓存却没杀干净托盘进程——这两处一漏，前面所有操作都白做。
