VSCode极速版(Portable Mode)必须将locale.json置于data/user-data/User/路径下,内容为{"locale":"zh-cn"},并彻底重启生效;它不读取系统级配置,且中文包须通过内置扩展面板安装。

VSCode 极速版(Portable Mode)安装中文语言包,和标准安装版逻辑一致,但配置文件路径不同——不改对 locale.json 的位置,装完也白装。
怎么确认你用的是极速版(Portable Mode)?
极速版本质是便携模式:所有用户数据(包括扩展、设置、语言配置)都存在安装目录内,不写入系统路径。启动时若看到窗口标题栏末尾带 [Portable],或安装目录下有 data 文件夹,基本可确定是极速版。
- 典型路径示例:
D:\VSCode-Portable\data或/Applications/Visual Studio Code - Portable.app/Contents/Resources/app/data - 它**不会读取**
%APPDATA%\Code\User\locale.json(Windows)这类系统级路径,改了也无效 - 命令面板里的
Configure Display Language在极速版中有时无法生成正确的locale.json,建议手动操作
极速版必须改对的 locale.json 路径
极速版的 locale.json 必须放在 data/user-data/User/ 下,不是 data/User/,也不是 data/settings/ —— 多一个层级、少一个层级都会失效。
- Windows:
D:\VSCode-Portable\data\user-data\User\locale.json - macOS:
/Applications/Visual Studio Code - Portable.app/Contents/Resources/app/data/user-data/User/locale.json - Linux:
/opt/vscode-portable/data/user-data/User/locale.json - 如果该路径不存在,**手动创建完整目录结构**(注意大小写:user-data 是连字符,不是 userdata 或 User_Data)
- 文件内容仅一行:
{"locale":"zh-cn"},UTF-8 编码、无 BOM、无多余空格或逗号
中文语言包安装必须走官方扩展市场
极速版不支持离线拖拽安装 .vsix(部分旧版可能报“signature verification failed”),必须通过内置扩展面板安装,否则扩展无法注册进当前便携实例。
- 启动极速版 → 按
Ctrl+Shift+X打开扩展面板 → 搜索Chinese (Simplified) Language Pack for Visual Studio Code - 只认发布者为
Microsoft、ID 为ms-ceintl.vscode-language-pack-zh-hans的那一项 - 装完别点右上角 “Reload Window”,必须彻底退出所有进程(Windows 查任务管理器里是否还有
Code.exe,macOS 查 Activity Monitor 中Electron) - 再启动,界面才真正加载中文翻译
重启后还是英文?先看状态栏右下角
状态栏右下角显示 en,说明 VSCode 正在用英文启动,locale.json 要么没被读到,要么值写错了。
- 常见错误值:
"zh"、"zh_CN"、"Chinese"、"zh-hans"—— 全部无效,只接受"zh-cn"(小写、短横线、双引号) - 用 VS Code 自己打开
locale.json,不要用记事本或 Sublime,避免编码污染 - 极速版下,扩展安装后不会自动触发
locale.json创建,靠命令面板也不一定可靠,**手动建 + 手动写 + 彻底重启是最稳路径** - 如果已安装其他语言包(如日文、韩文),它们会干扰语言协商逻辑,建议卸载非必要语言扩展
极速版的「便携」特性是一把双刃剑:配置不污染系统,但也意味着每一步都要落在它自己的沙盒路径里。错一个斜杠、少一个 user-data 目录层级,就等于没配。


















