Visual Studio Code 安装这件事网上教程一抓一大把但我这两年帮同事、学员装机子发现一个很普遍的问题装完是装完了界面全是英文想改中文又找不到入口或者改完中文后一更新又变回英文。还有一些人卡在安装选项上不知道 User Installer 和 System Installer 到底该选哪个最后装完连右键菜单都是乱的。这篇文章就把“Visual Studio Code 安装 中文环境配置”这条线完整走一遍从下载、安装、界面汉化到基础环境设置全记录我自己的实操过程顺便把踩过的坑和排查思路也一并写清楚。如果你是第一次接触 VS Code或者刚重装完系统准备配环境这篇可以直接照着做如果你已经用了一段时间但一直没搞定中文界面可以直接跳到第 3 章如果你装完之后想顺手把字体、终端、编码这些基础项也调好第 4 章和第 5 章的清单可以帮你省不少事。1. 装前准备先搞清楚你要装的是哪一版1.1 为什么大家都在用 VS CodeVS Code 全称 Visual Studio Code是微软出品的一款免费开源编辑器。它和 Visual Studio就是那个几个 GB 的 IDE是两码事VS Code 本体只有几十 MB轻量、启动快、插件生态极其丰富。无论是写 Python、JavaScript、C/C、HTML还是做 Flutter、Vue 3 之类的项目社区里都有现成的插件可以配。这也是它能在短短几年内成为开发者装机率最高的编辑器之一的原因。不过“轻量”也意味着很多东西不是开箱即用尤其是中文语言包这种基础需求默认状态下得手动安装。如果你刚接触它建议先花两分钟把下面几个概念理清楚避免后续操作时对不上号。1.2 版本选择User Installer 和 System Installer 的区别去官网下载页面会看到两个 Windows 版本User Installer 和 System Installer。我实测过两个版本区别就在安装权限和安装位置上User Installer装到当前用户的 AppData 目录下不需要管理员权限不影响系统其他账户。适合公司电脑、权限受限的机器或者你只是个人使用。System Installer装到 Program Files 目录下所有用户都能用但安装时要求管理员权限。适合公用机器或者你需要右键“以管理员身份打开”的场景。我自己通常选 User Installer因为 VS Code 的更新机制对用户目录的写入更友好不需要每次更新都弹 UAC 授权。如果你是用学校或公司的公用电脑也想避免权限问题优先考虑 User Installer。这里还要注意一个版本细节官网首页默认下载的是 Stable 稳定版旁边还有 Insiders 预览版。不是搞插件开发或者尝鲜的话不要碰 Insiders它更新频繁偶尔有稳定性问题不适合日常写代码。1.3 下载渠道和安装包校验VS Code 官网地址是 code.visualstudio.com直接点 Download 就行。下载页面会按你的系统自动推荐对应版本Windows 用户通常就是 64 位的 User Installer。如果你不确定系统位数可以按 Win Pause 打开系统信息查看绝大多数现代电脑都是 64 位。下载完成后可以先看看文件大小一般稳定版的 Windows 安装包在 70MB 到 100MB 之间不同版本会有浮动。如果下载的文件只有几 MB大概率下载不完整或者进了某些垃圾下载站的捆绑包建议直接删掉重新去官网下。注意网上搜“VS Code 下载”很容易点到第三方下载站这些站点经常捆绑修改版安装包安装时可能夹带广告软件。认准官网域名安装包签名是 Microsoft Corporation这个细节值得养成习惯。2. 安装全流程从下载到首次启动2.1 Windows 端安装步骤双击安装包后第一步是同意协议这个没什么好说的。真正需要注意的是进入“选择附加任务”这一步。你可能会看到这样几个选项创建桌面快捷方式按需勾选将“通过 Code 打开”操作添加到文件和目录上下文菜单建议勾选将“Code”注册为受支持的编辑器建议勾选添加到 PATH必须勾选这个决定了你能不能直接在终端里输入code命令来启动编辑器在 Windows 上启用 64 位 Shell 扩展可勾可不勾其中“添加到 PATH”是最关键的。我见过不少教程没提这茬导致后面想用命令行code .打开当前目录时直接报“不是内部或外部命令”。如果当初忘勾了也不用重装装完打开 VS Code按 Ctrl Shift P输入 “Shell Command: Install ‘code’ command in PATH”就能手动补上。安装过程中还有个容易忽略的小点如果你开了杀毒软件或者系统自带的 SmartScreen可能会弹提示。只要确认是从官网下载的放心点“仍要运行”。安装完成后首次启动 VS Code如果你在第四步选择了“通过 Code 打开”的右键菜单以后在任意文件夹上右键就能直接用 VS Code 打开这个习惯养成后效率提升很明显。2.2 Mac 和 Linux 安装简述Mac 上有两种方式官网下载 .zip 文件解压后把 Visual Studio Code.app 拖到 Applications 文件夹即可或者如果你装了 Homebrew一条命令就能搞定brew install --cask visual-studio-code。我更喜欢 Homebrew 的方式升级也方便直接brew upgrade visual-studio-code。Linux 用户的话Debian/Ubuntu 系可以下载 .deb 包用sudo dpkg -i安装Arch 系可以直接sudo pacman -S code。如果你用的是 Windows 上的 WSL2 环境也可以直接在 WSL 里装 Linux 版这样访问 Linux 文件系统时没有跨文件系统的性能损耗。不管什么系统记住一点VS Code 是用户级配置优先的工具配置文件默认在用户主目录的.vscode文件夹里不需要动系统目录。2.3 安装目录和文件结构的说明Windows 下 User Installer 的安装路径默认是C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code。之所以单独说这个路径是因为你在排查插件、缓存、配置文件时会用到。VS Code 主要依赖几个位置安装目录程序本体用户配置目录%APPDATA%\Code\User\settings.json扩展插件目录C:\Users\你的用户名\.vscode\extensions缓存目录%APPDATA%\Code\Cache遇到“插件装了但没生效”或者“配置改了半天没反应”这类问题很多时候删掉缓存目录或手动检查扩展目录就能定位原因。尤其是后面配置中文环境时如果你在扩展商店里搜索不到语言包很可能就是扩展目录权限受损直接去.vscode\extensions下新建文件夹再手动丢文件就能绕过。3. 中文环境配置两种主流方式3.1 通过扩展商店安装中文语言包推荐VS Code 的中文支持就是通过官方语言包插件实现的这个插件叫“Chinese (Simplified) (简体中文) Language Pack”发布者是 Microsoft。操作步骤很简单打开 VS Code点击左侧边栏的扩展图标就是四个正方形的那个图标或者按快捷键 Ctrl Shift X在搜索框输入Chinese (Simplified)找到发布者为 Microsoft 的那个语言包点击 Install等待安装完成后右下角会弹出提示框问你是否立即切换到中文界面点“Change Language and Restart”即可重启后整个界面就是中文了包括菜单栏、设置面板、右键菜单、内置终端标题栏等。这里有个很常见的坑插件明明显示安装成功但界面还是英文。我遇到这种情况九成原因是 VS Code 的显示语言没有被切换或者安装后没有正确重启。如果重启后还是英文按快捷键 Ctrl Shift P 打开命令面板输入Configure Display Language回车后会打开一个locale.json文件把locale: zh-cn保存再完全退出 VS Code 重新打开就能切过来。3.2 命令行安装语言包如果你是在远程服务器或者 WSL 环境里操作不方便打开图形界面可以直接用命令行装code --install-extension ms-ceintl.vscode-language-pack-zh-hans装完后同样需要设置 locale可以在命令行里直接改配置文件。先运行code --localezh-cn启动临时中文界面或者直接修改 settings.json 中的locale字段。不过这里要注意locale.json和settings.json是两个文件。VS Code 的显示语言保存在locale.json在%APPDATA%\Code\User目录下而settings.json保存的是编辑器功能配置。第一次切换语言时VS Code 会自动帮你生成 locale.json如果这个文件不存在或内容为空界面就不会变中文。这是很多人改完设置发现无效的根本原因。3.3 安装后的语言验证与小细节重启后你可以点开“帮助”菜单看看是不是显示为中文。也可以看设置面板左侧的搜索框、菜单文字如果全部变成中文说明成功了。语言包切换后有个小细节如果你同时装了其他语言包比如日本语、English再次打开 Configure Display Language 时就能看到语言选项列表可以从这里随时切换。日常使用中如果发现某些 UI 元素还是英文不用太纠结新版 VS Code 偶尔有少量新增功能未完全本地化这是正常现象不影响使用。另外提一句中文语言包是支持增量更新的通常 VS Code 主程序更新后它也会在后台自动更新。如果哪次打开发现界面变回英文先查一下是不是语言包被禁用或更新失败重新安装一次语言包基本都能解决。4. 从中文界面到可用 IDE装完后的关键设置界面变中文只是第一步一个能流畅写代码的 VS Code 还需要做几项基础配置。这一节我按自己重装系统后必改的清单来写。4.1 工作台基础设置打开设置界面Ctrl 先调整几个影响日常体验的选项window.zoomLevel界面缩放级别。如果你在高分屏上觉得字体太小按住 Ctrl 滚轮可以直接缩放整个界面它会自动改这个值。我个人习惯调成 1对 14 寸笔记本的 2K 屏来说比较舒服。editor.fontSize代码字体大小默认 14我改成 16。这个看个人习惯长时间盯代码建议稍微大一点不然眼睛容易干。files.autoSave自动保存。我一般设为afterDelay延迟时间 1000ms这样切窗口时不用手动 Ctrl S减少一个操作步骤。workbench.colorTheme主题配色。喜欢浅色用Light喜欢深色用Dark也可以装社区主题插件。这个不影响功能但影响心情建议选一个看着不刺眼的。这些配置都可以直接在设置界面的搜索框里输入关键字找到不用记路径。4.2 字体、终端和编码配置这是最容易出乱码和踩坑的地方。字体VS Code 默认字体是 ConsolasWindows 下中文注释偶尔会有显示不对齐的问题。可以装一个“Sarasa Gothic”更纱黑体或者“JetBrains Mono”然后在设置里配置editor.fontFamily。配置多个字体时用逗号分隔VS Code 会按顺序选择可用字体。终端VS Code 内置终端在 Windows 下默认是 PowerShell。如果你更习惯 cmd 或者 Git Bash可以在设置里改terminal.integrated.profile.windows。我目前用的是 Git Bash主要因为它对 Linux 命令支持好而且配合 Git 操作更顺畅。这个选项在设置界面搜“terminal”就能看到。编码Windows 下中文版最常见的问题是 GBK 编码的文件打开后乱码。新版 VS Code 默认用 UTF-8遇到 GBK 文件时你可以点击右下角状态栏的编码按钮显示“UTF-8”的位置选择“通过编码重新打开”然后选“简体中文(GBK)”文件内容就能正常显示。如果你经常处理老项目文件可以在设置里把files.autoGuessEncoding设为 true这样 VS Code 会自动猜测编码乱码概率大幅下降。我曾碰到过这样一个案例同事用 VS Code 打开一个 GBK 编码的 Python 文件中文注释全是乱码他以为是文件坏了。其实只是编码识别问题按上面步骤重新打开一遍就好了。所以编码这个设置我建议每个人都提前配好省得下次用的时候手忙脚乱。4.3 常用快捷键和布局调整快捷键是提高效率的重头戏。不要求死记硬背但下面这几个高频操作值得记住Ctrl P快速打开文件。只需要输入文件名的一部分就能跳转Ctrl Shift P命令面板。所有 VS Code 功能都能在这里搜索执行Ctrl Shift X打开扩展面板Ctrl ,打开设置Ctrl 打开/关闭集成终端Ctrl B显示/隐藏侧边栏Alt 上/下箭头向上/下移动当前行Ctrl D选中当前单词再按一次可选择性多选下一个相同单词这是批量修改变量的利器布局方面如果你需要同时查看多个文件可以拖动文件标签到侧边区域实现分屏。分屏之后编辑器右上角的“更多操作”三个点菜单里可以选择编辑器布局方向上下分屏适合对比代码左右分屏适合边写代码边看参考。5. 常见问题与排查技巧实录5.1 界面仍是英文语言包重启无效这个问题出现频率最高。先排除一个低级原因你装的语言包是否正确。搜索时有可能装了第三方开发者发的“简体中文包”虽然名称相近但不是微软官方出品效果没法保证。认准发布者是 Microsoft插件全名是 Chinese (Simplified) (简体中文) Language Pack。如果插件没问题按 Ctrl Shift P 执行Configure Display Language检查 locale.json 里的 locale 值是否是zh-cn。有时候文件里会同时存在多个配置项语法错误会导致 VS Code 读取失败它会静默回退到英文。可以用 JSON 校验工具检查一下或者直接把文件内容清空成{locale: zh-cn}再重启。还有一个情况用户目录权限不足导致 VS Code 写了 locale.json 后无法保存。这种情况在公司的域用户电脑上比较常见。解决方法是右键 VS Code 图标选择“以管理员身份运行”切换完语言后重启回普通模式即可。如果这一步不奏效也可以尝试把配置目录的只读属性去掉。5.2 终端里输入中文乱码或显示方框这个问题大多出在字体和终端编码上。先检查设置里的terminal.integrated.fontFamily如果它没有继承全局字体可以手动设置为与编辑器相同的字体。接着确认终端编码PowerShell 默认编码在 Windows 10 以上一般是 UTF-8但旧版本系统可能出现 GBK 编码冲突。可以在终端里执行chcp 65001切换为 UTF-8 代码页这条命令对中文环境基本够用。想彻底解决可以将terminal.integrated.env.windows中加上PYTHONIOENCODING: utf-8这个选项对 Python 输出中文特别有用。方框问题的根源通常是字体缺少 CJK 字符集。Consolas 对中文的支持就不算好换成 Sarasa Gothic 或者微软雅黑后终端里的中文方框基本消失。5.3 安装后启动报错或闪退的处理思路常见的启动报错有两类一类是“无法启动 Visual Studio”这类 ServiceHub 连接错误另一类是双击图标无反应或闪退。第一类多见于安装了多个微软开发工具的环境ServiceHub 进程被占用或版本冲突。你可以先找到 VS Code 安装目录打开终端执行code --status查看进程状态如果能看到相关错误信息优先尝试关闭所有 VS Code 进程包括后台的 Code.exe然后重启。第二类情况可能是显卡驱动不兼容导致的软件渲染问题。可以尝试添加启动参数code --disable-gpu来绕过 GPU 加速看能否正常打开。如果能打开那就是显卡驱动或硬件加速的问题可以在设置里搜索window.disableHardwareAcceleration勾选为 true问题通常就不会再出现。还有一个容易忽略但不难解决的情况杀毒软件把 VS Code 的部分文件隔离了。检查一下杀毒软件的隔离区如果有关于 Code.exe 或相关 dll 的记录恢复并加入信任列表即可。5.4 装完 VS Code 后还需要配这些环境只装 VS Code 还写不了代码等于是“毛坯房”还需要根据你的开发方向装对应的运行时环境。这里把几组最常见配置列一下写 Python装 Python 解释器VS Code 里安装 Python 扩展写 C/CWindows 上需要 MinGW 环境搜索安装 mingw-w64并在 VS Code 中安装 C/C 扩展写 Java安装 JDK 并配置 JAVA_HOME 环境变量VS Code 里安装 Extension Pack for Java写 Git安装 Git for WindowsVS Code 里就能直接使用源代码管理面板写 Flutter安装 Flutter SDK并安装 Dart 和 Flutter 扩展如果这些环境已经装好了VS Code 的集成都非常顺畅——打开代码目录右下角会提示识别项目类型点击就能自动加载推荐的扩展和调试配置。提示VS Code 内置的终端在 Windows 上默认使用 PowerShell如果你希望命令行工具比如 Python、Git在 VS Code 里能直接运行记得把它们的路径添加到系统环境变量 PATH 中。安装 Git 时默认会勾选“Git from the command line”Python 安装时勾选“Add Python to PATH”这两个勾选建议都不要取消。6. 安装后再优化这 5 个扩展值得先装语言包只是第一步装完之后我建议你顺手把这几个扩展也装上都是高频使用的Prettier - Code formatter代码格式化神器保存时自动整理代码ESLintJavaScript/TypeScript 代码检查Python微软官方 Python 支持包括调试、智能提示、JupyterGitLens增强 Git 可视化提交记录一目了然Material Icon Theme文件图标美化有助于一眼辨认文件类型扩展不在多而在于匹配你的工作类型。如果你写前端需要 Vue 的话可以把 Volar原 Vetur 的替代也加上如果你用 Docker装一个 Docker 扩展可以直接在 VS Code 里管理容器。扩展装多了要留意性能问题。每一个扩展都会在启动时加载装几十个以后 VS Code 启动速度会明显下降。我自己的习惯是只留常用的大约 10 个左右其余按项目需要临时启用。在扩展面板里可以禁用不用的扩展不用卸载留着方便日后切换。7. 写在最后的几点经验我实际操作下来的体会是VS Code 安装和中文环境配置本身并不难大部分问题都出在细节上要么是语言包装错、要么是 locale.json 没写对、要么是编码设置冲突。这些问题用一篇教程的时间理清一次以后再碰到就不会手忙脚乱。最后再分享一个小技巧如果你要在多台电脑上配置 VS Code可以登录 GitHub 或微软账号在设置面板里开启“设置同步”这样主题、快捷键、扩展配置都能云同步。新机器上装完 VS Code登录账号后等几十秒所有环境就自动恢复了不需要再一遍遍手动配置。这对我这种经常重装系统的人来说省下的时间可不是一点半点。装好中文环境之后记得打开一个真实项目试试。不用急着追求把每个配置都调到位先把基本流程跑通等后面遇到具体需求再回来搜索对应的设置项就行了。VS Code 的可玩性很高这也是它让人越用越顺手的原因。
