vscode中文包安装失败主因是版本兼容、代理配置或locale设置错误：遇“not compatible”需修改package.json中engines.vscode字段；json解析错误说明代理未通，应检查http.proxy格式及network请求；装完仍英文须确认%appdata%\code\user\locale.json（windows）等路径下{"locale": "zh-hans"}准确且重启彻底。
VSCode 中文语言包安装失败，99% 不是插件问题，而是版本声明、代理配置或 locale 设置卡在某个具体环节——错误信息里那几个英文词，直接对应修复路径。
看到 “not compatible with VS Code '1.xxx'” 怎么办
这是 engines.vscode 字段语义化匹配失败，不是网络或权限问题，VS Code 启动时就拒绝加载，连日志都不记。常见于刚升级 VS Code 到 1.102+，但下载的 ms-ceintl.vscode-language-pack-zh-hans 包只标了 "^1.103.0"。
- 用 7-Zip（Windows）、
unzip（Linux/macOS）解压 .vsix 文件 - 进
extension/package.json（不是根目录那个），改"vscode": "^1.103.0"为"vscode": ">=1.85.0"（推荐，兼容宽）或"vscode": "^1.90.0"（以code --version输出为准） - 保存后重新打包为 ZIP，后缀名改回
.vsix - 命令面板执行
Extensions: Install from VSIX，选这个改过的文件
安装时提示 “Unable to open 'Extension: …'” 或 JSON 解析错误
错误信息末尾出现 Unexpected token ，说明 VS Code 尝试读取一个 HTML 响应（比如 404 页面、登录跳转页、代理拦截页），误当 JSON 解析了。本质是网络请求根本没到 Marketplace。
- 检查
http.proxy是否显式配置，格式必须是http://127.0.0.1:7890（不能写localhost，且必须带协议头） - 确认
http.proxyBypassList没把127.0.0.1自动绕过；可临时改成局域网 IP，如http://192.168.1.100:7890 - 打开开发者工具（
Help → Toggle Developer Tools），切到 Network 面板，点安装，看有没有发向https://marketplace.visualstudio.com/_apis/public/gallery/的请求 - 若状态为 Pending 或无任何请求，说明代理根本没走通，不是插件问题
装完重启还是英文？检查 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，大小写、短横线都必须严格） - 如果文件不存在，手动创建；如果存在但值是
"en"或空，直接改掉并保存 - 改完必须完全退出 VS Code（任务管理器杀光所有
Code.exe进程），再启动
Remote-SSH / WSL 下中文不生效
本地配置对远程无效。VS Code Server 是独立进程，只读远程机器上的 locale.json，不继承本地设置。
- 登录远程机器，进
~/.vscode-server/data/Machine/（后面是带哈希的子目录） - 在此目录下创建或修改
locale.json，内容同上：{"locale": "zh-hans"} - 断开 Remote-SSH 连接，再重连——vscode-server 启动时才读这个文件，热重载无效
- 别往
~/.bashrc里写export HTTP_PROXY，SSH non-interactive shell 不加载它
真正难搞的从来不是“怎么装”，而是装完发现没反应，又看不出哪错了——这时候盯紧错误信息里的英文关键词，而不是猜中文意思；删缓存、查路径、验格式，每一步都得落在实处，少一步都白忙。
