VSCode如何安装与汉化_新手第一步应该做什么【教程】

13次阅读

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 推荐 .exemacOS 选 .zip.dmglinux.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 WindowCtrl+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:UsersXXXappDataLocalProgramsMicrosoft VS Codebin)加进系统环境变量
  • 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 可能被同步工具覆盖,建议首次配置后手动备份该文件。

text=ZqhQzanResources