执行 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 却误改了外层根目录的文件,或是删了缓存却没杀干净托盘进程——这两处一漏,前面所有操作都白做。


















