VSCode中文界面需安装官方Chinese (Simplified) Language Pack扩展并重启生效,安装时须勾选Add to PATH,配置locale为"zh-cn"且避免系统区域设置干扰。
vscode 本身没有官方中文语言包,所谓“汉化”其实是通过安装 chinese (simplified) language pack for visual studio code 扩展来切换界面语言,不是修改系统文件或破解。装错扩展、没重启、或系统级语言设置干扰,是新手卡住的最常见原因。
下载安装 VSCode:认准官网,别用第三方渠道
直接访问 https://code.visualstudio.com/,点击首页大按钮下载对应系统的安装包(Windows 推荐 .exe,macOS 选 .zip 或 .dmg,Linux 用 .tar.gz 或包管理器)。不要从软件管家、XX加速器或百度网盘链接安装——这些可能捆绑插件、修改默认启动参数,甚至替换 code 命令行为。
安装时勾选「Add to PATH」(Windows/macOS)和「Register Code as an editor for supported file types」,否则后续在终端里敲 code . 会报错。
安装中文语言包:必须通过扩展市场,且要重启
打开 VSCode → 左侧活动栏点扩展图标(或按 Ctrl+Shift+X)→ 搜索 Chinese (Simplified) Language Pack for Visual Studio Code → 点击「Install」→ 安装完成后,**必须点击右下角弹出的「Restart」按钮,或手动执行 Developer: Reload Window(Ctrl+Shift+P 输入后回车)**。
常见错误:
- 搜到名字类似但发布者不是
Microsoft的“汉化插件”,那是旧版或非官方包,已失效 - 安装后没点重启,界面仍为英文——VSCode 不会热更新语言
- 系统区域设置为英文,且勾选了「Beta: Use native locale」,会导致语言包不生效
确认语言生效:检查设置项和状态栏
重启后如果还是英文,先按 Ctrl+Shift+P 输入 Configure Display Language 回车 → 确保右侧值是 zh-cn;再看右下角状态栏,应显示「中文(简体)」字样。如果显示「English」,说明配置没写入 locale.json。
可手动验证:Ctrl+Shift+P → 输入 Preferences: Open Settings (JSON) → 检查是否有这一行:
"locale": "zh-cn"
没有就加上(注意逗号分隔),保存后再次 Developer: Reload Window。
命令行 code 命令无效?重装或手动配置 PATH
安装时若没勾选「Add to PATH」,或者用了 macOS 的 .zip 版本,code 命令默认不可用。解决方法:
- Windows:重装 VSCode 并勾选选项;或手动把安装目录(如
C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin)加进系统环境变量 - macOS:打开 VSCode →
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 执行 - Linux(.tar.gz):把解压后的
bin/code软链接到/usr/local/bin/code,并确保有执行权限
执行 code --version 能输出版本号,才算真正就绪。
真正卡住的往往不是“怎么装”,而是装完没重启、PATH 没生效、或语言配置被其他插件覆盖。尤其多人共用一台机器时,locale.json 可能被同步工具覆盖,建议首次配置后手动备份该文件。










