如何设置VSCode中文界面不生效问题-VSCode-PHP中文网

必须执行configure display language命令并选zh-cn后重启，仅装中文包无效；该命令是唯一能生成正确locale.json并激活中文的入口。

如何设置vscode中文界面不生效问题

Configure Display Language 命令根本没执行

装了中文包但界面仍是英文，90% 是因为跳过了这一步——Configure Display Language 命令才是唯一能激活语言包的开关，插件本身只提供翻译资源，不自动切换语言。

常见错误现象：

命令面板（Ctrl+Shift+P）里搜不到 Configure Display Language —— 说明语言包根本没装成功或被禁用
搜到了但下拉列表为空，或只有 en 没有 zh-cn —— 插件未识别，需重装官方包
点了 zh-cn 后弹出 “Restart to apply changes” 却点了 Cancel 或只 Reload Window —— 配置不会落盘

必须严格按顺序操作：

按 Ctrl+Shift+P（macOS 用 Cmd+Shift+P），输入完整命令名：Configure Display Language
从下拉项中**明确点击** zh-cn（不是 zh、zh_CN、Chinese、zh-hans）
弹窗后点 Yes，不是关闭窗口再手动打开；Reload Window 不会重新加载语言资源

locale.json 路径错、内容错、权限错

locale.json 是 VS Code 实际读取语言配置的唯一文件，它不认 settings.json 里的 "locale" 字段（1.70+ 版本已弃用）。这个文件必须在用户级路径下，且内容严格受限。

正确路径：

Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json

文件内容必须是且仅是这一行（无空格、无 BOM、UTF-8 编码）：

{"locale":"zh-cn"}

容易踩的坑：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

手动生成该文件，VS Code 可能静默忽略——应优先通过 Configure Display Language 命令生成
写成 {"locale": "zh_CN"} 或 {"locale": "zh"} —— 全部无效，且无任何提示
文件存在但权限为只读（尤其 WSL 或远程挂载场景），VS Code 写入失败后 fallback 英文
误放在工作区 .vscode/ 下或系统级路径，VS Code 完全不读

远程开发（SSH/WSL）下中文失效

本地设好了，连上 Remote-SSH 或 WSL 后界面又变英文？这不是 bug，是设计如此：远程实例运行的是独立的 VS Code Server，它读取的是远程机器上的 locale.json，和本地完全无关。

必须单独处理远程端：

先确认远程已安装官方语言包：code --list-extensions | grep ms-ceintl
登录远程终端，定位并编辑远程 locale.json（不是本地路径）：

WSL/Linux：~/.vscode-server/data/Machine/locale.json（注意不是 ~/.config/Code/User/）
Remote-SSH：~/.vscode-server/data/Machine/<hash>/locale.json</hash>，<hash></hash> 是当前服务实例目录名

内容仍为 {"locale":"zh-cn"}，保存后在远程窗口中执行 Developer: Reload Window
若远程没装语言包，即使 locale.json 正确也无翻译资源可用

插件装错或被污染

搜“中文”“汉化”“zh-cn”安装的第三方插件（如 Chinese Language Pack、VSCode Chinese）基本都不可靠。它们不维护、不更新，轻则菜单乱码，重则触发 Cannot read property 'translate' of undefined 报错，甚至让 Configure Display Language 命令在命令面板里直接消失。

唯一有效的是微软官方插件：