免安装版vscode必须在首次启动前手动创建data目录,否则语言包无法正确安装启用;windows/macos/linux均需在code.exe或.app同级目录下新建空data文件夹,路径错误或缺失将导致configure display language命令不可见、中文不生效。

免安装版必须手动创建 data 目录才能存语言包
VSCode 免安装版(.zip 解压版)默认不会自动创建 data 目录,而官方中文语言包安装后必须写入该目录下的扩展缓存区,否则插件根本无法启用——你点“Install”看似成功,实际什么都没装进去。Windows/macOS/Linux 均需在解压后的 VSCode 根目录下**手动新建一个名为 data 的空文件夹**,位置必须是:Code\ 同级目录下,不是 resources/ 里,也不是 user-data/。
- Windows 示例路径:
D:\vscode-portable\Code.exe同级建data - macOS 示例路径:
/Applications/VSCode.app/Contents/Resources/app同级建data(注意:不是 app 内部) - Linux 示例路径:
~/vscode/code同级建data
没这一步,后续所有操作都无效;装完插件后命令面板搜 Configure Display Language 为空、右下角不弹提示,基本就是这个原因。
Configure Display Language 命令在免安装版里可能不显示?先确认语言包已启用
免安装版启动时若未检测到 data 目录,会 fallback 到系统级用户数据路径(如 %APPDATA%\Code\User),导致语言包被装到错误位置,Configure Display Language 命令就找不到依赖资源。验证方式很简单:
- 按
Ctrl+Shift+P输入Extensions: Show Installed Extensions - 检查列表中是否有
ms-ceintl.vscode-language-pack-zh-hans且状态为 Enabled - 如果没有,说明插件被装到了系统路径而非 portable 路径——删掉它,确保
data存在后再重装
别信右下角弹出的 “Reload Window”,那只是重载当前窗口,对语言切换完全无用;只有插件真正启用后,Configure Display Language 才会出现并可选 zh-cn。
手动写 locale.json 是免安装版最稳的兜底方式
免安装版的用户数据路径和标准版不同,它优先读取 data 目录下的配置。如果你已确认 data 存在、插件已启用,但命令面板仍异常或卡死,直接编辑 locale 文件是最可靠路径:
- 关闭所有 VS Code 进程(Windows 查任务管理器中是否还有
Code.exe或Code Helper) - 打开:
[解压路径]/data/User/locale.json(注意:不是%APPDATA%下那个) - 用 VS Code 自己新建该文件,内容仅一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码
这个文件一旦存在且格式正确,VS Code 启动时会强制加载,跳过任何 UI 层判断。很多内网或老旧机器上命令面板打不开,就是靠这招一击生效。
远程开发(WSL/SSH)下中文不生效?data 目录要分本地和远程两套配
免安装版连 WSL 或 Remote-SSH 时,VS Code Server 在远程端独立运行,它不读你本地 data 目录,而是读远程机器上的 ~/.vscode-server/data/Machine/xxx/locale.json。也就是说,你在本地设好了中文,远程终端、远程设置页、远程扩展界面仍是英文——这不是 bug,是设计如此。
- 登录远程环境(如 WSL 终端),执行:
code --list-extensions | grep zh-hans看语言包是否已装 - 若未装,先下载
vscode-language-pack-zh-hans-*.vsix文件,用code --install-extension xxx.vsix安装 - 再在远程路径
~/.vscode-server/data/Machine/[哈希目录]/locale.json中写入{"locale":"zh-cn"}
本地免安装版的便利性只覆盖本地实例;只要开了远程连接,就得把语言配置同步到远程侧,否则菜单栏、命令面板在远程窗口里永远是英文。
最容易被忽略的是 data 目录的创建时机——必须在第一次启动 VS Code 前完成,否则它会自动生成错误的用户数据路径并锁定;一旦走错,删掉整个 data 重来比排查配置快得多。











