这段时间被问得最多的问题之一就是“VS Code 怎么装怎么弄成中文”——提问的人里有刚转行学前端的、有学校课程要求装编辑器的、还有不少只是想改个代码文件却不知道怎么入手的普通用户。Visual Studio Code 这个编辑器这几年几乎成了默认选项不管你是写 Python、JavaScript、C还是做文档、写 Markdown它都能派上用场而且免费、跨平台、插件生态极其丰富。但正因为可选项多新手第一次启动界面是英文、还得接触一堆陌生概念很容易在第一关就被劝退。这篇文章就是一套完整的安装和汉化记录。从下载哪个版本、安装时每个勾选框要不要选到怎么装中文语言包、怎么在英文和中文界面之间自由切换再到装完之后顺手把哪些基础设置调好全部按实操顺序走一遍。最理想的情况是你照着操作二十分钟内就能把环境配好顺利进入“能用中文界面写代码”的状态。这篇文章主要面向刚接触编程、或者准备把 VS Code 作为主力编辑器的朋友也欢迎已经用过一段时间但一直没有搞定汉化、想重新整理环境的人来对照参考。1. 下载之前的版本选择和准备工作1.1 搞明白 VSCode 有哪些版本别再下载错Visual Studio Code 的下载页面其实藏着好几个选项新手经常看花眼。官网主链接code.visualstudio.com打开后页面正中会有一个醒目的蓝色下载按钮它会根据你的操作系统自动推荐一个版本。Windows 用户一般看到的是 “Windows User Installer x64”后面偶尔也有 “System Installer” 和 “Arm64” 之类的选项。第一次装的话优先选 “User Installer” 就好。这两个安装包有什么区别User Installer 是“只给当前用户安装”的版本安装时不需要管理员权限也不会往系统目录里写文件后面卸载和升级都很干净。System Installer 是“给整台机器所有用户安装”的版本适合公司统一配发、多账号共用一台电脑的场景但安装时必须拥有管理员权限装完后如果当前用户权限不足某些功能会受限制。我给朋友装机时默认都选 User Installer。很多小白一看到安装向导里写着“是否允许此应用对你的设备进行更改”就容易慌其实选 User 版就能避开管理员权限的弹窗整个过程顺畅很多。如果你用的是公司电脑没有本地管理员账号那更应该用 User Installer不然根本装不上。还有一点要提醒VSCode 主页上其实还分 Stable稳定版和 Insiders内测版。Insiders 每天更新、功能最新但也最容易出小问题。平时自己学习或者写作业用装 Stable 版就够了不用去追新。1.2 识别官网和第三方下载站的坑搜索“Visual Studio Code 下载”前几个结果里很容易混进第三方下载站页面做得跟官网很像但下载按钮可能是假的点下去会给你塞一堆捆绑软件、广告插件甚至改浏览器主页。我建议你记住官网域名或者直接通过搜索引擎找带“官方”标识的链接。判断标准很简单官网的下载页面不会出现“高速下载”“立即下载”“破解版”之类的按钮也不会有满屏的广告浮动窗。另外要留意扩展名。Windows 版下载下来的是一个 .exe 文件如果你下载到的是 .zip 压缩包那可能是绿色版或非官方打包版我不推荐用。VSCode 虽然确实有 zip 免安装版但对新手来说还是老老实实走安装向导比较省心右键菜单、PATH 环境变量、文件关联这些集成功能安装版能自动配好免安装版要手动搞徒增麻烦。顺便说一下 mac 和 Linux 用户。mac 下载 .zip 后解压把“Visual Studio Code.app”拖到“应用程序”文件夹就行Linux 用户一般用 .deb 或 .rpm 包也可通过 Snap 或 Flatpak 方式安装。这篇文章以 Windows 版本为主线但安装逻辑和汉化过程是通用的。2. 安装过程中的那些选项逐个说清楚2.1 安装向导的核心流程下载完 .exe 文件后双击运行第一页是许可协议直接点“我同意此协议”然后下一步。第二个页面是选择安装位置默认路径一般在 “C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code”。这里不需要改就放默认位置原因后面会讲。第三个页面是“选择开始菜单文件夹”也可以直接用默认值。真正的重点在“选择附加任务”那一页很多新手就是在这里因为不清楚每个勾选的含义而随便乱点后面用起来才发现缺乏某些基础功能。2.2 附加任务页面的关键选项解读这一页的选项分两大部分上面是关于快捷方式的下面是关于集成功能的。我逐个说一下每个选项的实际作用“创建桌面快捷方式”这个好理解要不要在桌面生成一个图标。建议勾上不然每次都要从开始菜单里翻。“将‘通过 Code 打开’操作添加到 Windows 资源管理器目录上下文菜单”这个选项非常实用。勾选后你在文件夹上右键菜单里会出现“通过 Code 打开”点一下就能直接用 VSCode 打开这个项目文件夹。“将‘通过 Code 打开’操作添加到 Windows 资源管理器文件上下文菜单”作用类似只是针对的是单个文件。右键某个代码文件选择“通过 Code 打开”会用 VSCode 打开该文件。经常跟文件打交道的人建议勾选。“将‘在 Code 中打开’操作添加到目录上下文菜单”这是给目录右键菜单再添加一个入口有些版本叫法不太一样本质上是让“Open with Code”出现在不同的菜单层级里。如果你已经勾了上面两个这个可勾可不勾。“将 Code 注册为受支持文件的编辑器”勾选后VSCode 会关联 .txt、.json、.md、.js 等常见文本文件双击这些文件会直接调用 VSCode 打开。不想每次都经过“文件-打开”操作的话就勾上。“添加到 PATH重启后生效”这个是我最强调的一个。勾选之后安装程序会把 VSCode 的可执行文件路径加入系统环境变量这样你在终端里敲一个“code .”命令就能直接用 VSCode 打开当前目录。很多老手在教程里用到这个命令都是建立在勾了这个选项的基础上。如果你没勾后续在终端里用“code”就会提示找不到命令。有些人会担心“添加到 PATH”会不会搞乱电脑其实完全不会。它只是在环境变量里追加了一条 VSCode 的安装路径对系统没有副作用。建议所有第一次安装的人都勾上。2.3 安装完成后的第一次启动检查安装完成后点击“完成”启动 VSCode第一次打开会看到一个欢迎页面整体界面是英文的右侧有一个“Get Started with VS Code”的引导区域。进来后先不要急着装插件我建议你先打开系统终端也就是按 WinR 输入 cmd或者直接在搜索栏输“命令提示符”然后在里面敲一句code --version如果返回了类似 “1.9x.x” 的版本号说明 PATH 配置成功终端能直接调用 VSCode。如果提示“不是内部或外部命令”先别急重启一遍电脑再试。重启后依然不行大概率是第一步“添加到 PATH”没勾上那时要么重装一遍安装包把路径加上要么手动去改系统环境变量但后者操作会比较麻烦所以再次强调一开始就勾上的重要性。安装过程中最常见的两个反应一个是“安装好慢”一个是“我是不是装坏了”。前者通常是因为电脑上杀毒软件在实时扫描安装包放行或者等一会就好。后者一般是因为中间的某个按钮被误点导致提前退出重新执行安装包走一遍流程就能解决。安装本身不会动你的现有软件和代码文件完全可以放心。3. 中文环境的配置全过程3.1 安装中文语言包界面变成中文的核心一步VSCode 默认是英文界面但它本身是支持多语言的只是语言包需要额外安装。这一步也是标题里“中文环境配置”最重要的环节。操作路径是启动 VSCode点击左侧活动栏上的“扩展”图标也就是四个小方块的图标或者直接用快捷键 CtrlShiftX。在扩展面板顶部的搜索框里输入“Chinese”回车后会出现一个由 “Microsoft” 发布的扩展全名叫 “Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code”。确认一下发布者是 Microsoft看清楚再点“安装”。这一步要注意的是有些复制站或者第三方插件市场会仿冒这个语言包名称相近但发布者不是微软安装后界面不一定能变中文甚至可能带入一些不安全的代码。所以认准发布者是 Microsoft 很关键。在扩展详情页面里可以看到发布者信息是微软官方账号带着蓝标验证的那种。安装完成后安装按钮会变成“重新加载”或“更改语言并重启”VSCode 会弹出一个右下角的提示框问你是否要立即用简体中文重启。这时直接点“更改语言并重新启动”界面就会刷新成中文。如果这个提示框被你不小心关掉了也完全不用慌可以用命令面板来手动切换后文会详细介绍。3.2 通过命令面板切换显示语言的操作细节如果弹窗没有出现或者你在系统里装了好几个语言包想来回切换最通用的方式是用命令面板。按 CtrlShiftP 打开命令面板输入“Configure Display Language”在下拉列表里选择“中文(简体)”。这个动作本质上是改写 VSCode 用户配置文件里的 “locale” 参数切换到中文后该值会变成 “zh-cn”。设置后 VSCode 会提示需要重启才能生效按提示操作即可。命令面板这个入口值得多提一句它可以执行 VSCode 内部的绝大多数操作等于一个万能搜索框。你以后想调整任何设置、运行某个命令不记得具体菜单路径时都可以先按 CtrlShiftP 再输入关键词。这个习惯早点养成后面会省非常多的时间。我还遇到过一种情况有些用户装完中文包后菜单栏确实变了中文但底部面板、搜索框提示、设置搜索的某些描述还是英文。这通常是因为重启不彻底。最稳妥的办法是将所有 VSCode 窗口都关掉然后再重新启动。默认情况下 VSCode 会让你重新打开之前的窗口所以不会丢失当前项目状态。极少数情况下菜单栏是英文而其它部分正常那多半是操作系统区域语言设置和 VSCode 的 locale 参数产生了冲突可以在“设置 颜色主题下方找到语言模式”或者通过刚才的 Configure Display Language 命令强制改为 zh-cn 并重启。3.3 中文包安装后如何验证和切回英文界面配置完成后整个界面包括菜单、右键菜单、设置面板、欢迎页都会变成简体中文但插件市场里第三方插件的说明文字不一定全是中文这属于正常现象。如果你只是想熟悉一下功能用中文界面帮助很大但如果你以后想找某些英文技术资料或者跟着英文教程操作有可能需要切回英文界面。方法也很简单还是用 CtrlShiftP 打开命令面板输入“Configure Display Language”这回选择“English”然后重启即可。语言切换这一点对新手特别友好因为它不是像某些软件那样需要重装也不改变任何项目配置。语言文件和程序主体是分开的切换后不会影响你写代码、装插件、调试调试器的功能。真正需要记住的一点是界面语言只是表象不影响你的代码文件内容和执行逻辑代码字符串由你写的程序决定不会因为编辑器变成中文就把程序的报错也翻译了。3.4 从原理上理解语言切换为什么这么方便从学过编程的角度来看VSCode 这种“语言包即扩展”的设计思路很典型把一个软件的文本资源抽离出来由扩展市场统一分发。所以你不需要为了中文界面重新下载一个所谓“中文破解版”或者“汉化版安装包”只需要在现有安装版本上叠加一个语言包。这就意味着你得到的始终是最新的官方编辑器本体同时又能像使用原生中文软件一样使用 VSCode。不少国人第一次接触时会习惯性搜索“VSCode 汉化版”但这类搜索结果质量参差不齐很多附加了不必要的东西。我一直建议大家装官方原版再加官方中文语言包原因就在这。安装一个插件就能实现汉化何必去冒重装未知来源软件的风险。4. 装好和汉化之后顺手做这几个基础设置4.1 调整编辑器初始设置三件套中文界面落地后可以先把几个影响日常使用舒适度的设置调好。打开设置界面Windows 上用快捷键 Ctrl逗号或者在菜单栏“文件 首选项 设置”进入。在设置搜索框里搜三个关键词并分别确认。第一个是“自动保存”。搜索“Auto Save”把“文件 自动保存”打开或者直接搜索 “files.autoSave”把值改为 “afterDelay”。这样写代码时不用每次 CtrlS文件会在停止输入一小段时间后自动保存手误导致临时文件丢失的概率大幅下降。第二个是“字体大小”。搜“Font Size”默认是 14屏幕分辨率高或视力偏弱的人可以改到 15 或 16。第三个是“Tab 键是否转换为空格”。搜“Insert Space”默认情况下 VSCode 会在你按 Tab 时插入两个或四个空格这对 Python 这类对缩进敏感的语言非常友好建议保持默认。这几个设置不在同一个界面但搜索框都能快速直达。4.2 用“打开文件夹”的方式管理项目别把单文件当主力方式VSCode 的局工作区逻辑是“文件夹优先”。如果你直接双击一个 .py 或者 .js 文件VSCode 确实能打开但它只会把这个文件当作孤立的单文件来处理智能提示、调试器、版本控制等功能都会受限。正确的做法是在欢迎页点击“打开文件夹”选中你的项目根目录。左上角的资源管理器里就会显示整个项目的文件树这样你写代码时能很方便地在多个文件之间跳转微服务、前端工程、Python 脚本等都会好用很多。这个理念新手需要尽早建立。VSCode 更像是一个“以项目为单位”的编辑器而不是“一个文件窗口配一个标签页”的记事本替代品。把文件夹放进 VSCode 之后代码补全、错误检查、Git 状态、终端路径都会跟着整个项目走体验是天差地别的。4.3 集成终端和“code .”命令效率直接上一个台阶VSCode 自带一个集成终端可以通过快捷键 Ctrl反引号 打开也可以从菜单“查看 终端”进入。这个终端在当前文件夹内直接打开路径自动是项目根目录省去切换文件的麻烦。比如你写完一段 Python 代码可以直接在终端里输入python xxx.py马上看到输出。想打开 npm 项目就输入 npm install过程全部在同一个窗口内完成。再配合之前 PATH 里添加的“code”命令你在资源管理器某个文件夹地址栏里输入“cmd”打开终端然后输入“code .”当前文件夹就会直接在 VSCode 里打开。这两招配合使用流程大概是这样文件夹右键 → 通过 Code 打开或地址栏输入 cmd → code .。都是非常高频的“老手式”操作。4.4 安装几个真正高频的扩展少走弯路汉化完成后你在扩展面板搜索某个语言的关键字现在可以看到中文说明这个时候就可以按需装一些官方高频插件了。我这里列几个覆盖面最广的写 Python 就装 PythonMicrosoft 出品、写前端装 ESLint 和 Prettier、写 C/C 装 C/C 扩展包、写 Markdown 时 Markdown All in One 很实用、所有场景都值得装一个 GitLens 用来查看代码历史、Code Runner 可以快速运行各类语言的单文件脚本。这里要特别提醒一句扩展装太多了反而会让编辑器变慢、启动变卡。尤其是第一次接触 VSCode 的人经常一次性装二三十个插件实际上大部分用不上。我的建议是“按需安装”用到哪种语言或工作流就装对应的那一两套。关闭 VSCode 前如果感觉非常卡可以在帮助菜单里的“性能”面板查看哪些扩展拖慢了速度。还有一个很多人不知道的小技巧VSCode 左侧活动栏里默认有一排图标中文环境下有些图标只有英文名。比如“源代码管理”对应的其实是 Git 面板。不要把界面“必须全中文”当成唯一目标VSCode 的专业术语有时保留英文反而更容易跟社区教程对齐。5. 安装配置过程中的常见问题和排查思路5.1 几个高频问题的速查表很多问题是反复出现的我直接整理成一张表。照着问题和处理方式来对号入座即可。问题现象可能原因解决办法安装完成后桌面上找不到图标附加任务页面没有勾选桌面快捷方式在开始菜单搜索“Visual Studio Code”右键发送到桌面或重装勾选终端里输入 code 提示找不到命令安装时“添加到 PATH”未勾选重装安装包并勾选或手动编辑系统环境变量加入 VSCode 路径界面一直还是英文中文包已经装了语言包安装后没有重启或 locale 未生效CtrlShiftP输入 Configure Display Language选择 zh-cn 并重启中文包安装按钮显示“重新加载”但点后无反应扩展安装源问题或网络不畅打开“帮助 切换开发人员模式”查看日志或在扩展面板搜索并重装打开 vscode 后非常卡风扇狂转扩展装太多或某个扩展冲突禁用最近安装的扩展逐一排查查看“帮助 进程管理器”插件安装特别慢或搜索不到网络环境限制访问插件市场关闭代理或加速器后再试或更换网络热点检查系统时间是否正确代码提示没有出现对应语言的扩展没安装或没激活确认已安装该语言官方扩展并重启 VSCode打开该语言文件触发激活底部面板终端显示 cmd 但命令报错当前集成终端类型不对或路径中带空格点击终端类型下拉按钮选择 PowerShell 或默认 shell用“cd /d 路径”切换目录5.2 遇到“插件市场全是英文说明”和“窗口无法启动”的情况怎么办前面说过界面语言包只翻译 VSCode 主程序自己的文本不会翻译成插件市场里每个第三方扩展的说明文字。所以你会发现扩展页详情部分还是英文这是正常现象代表它还没有做中文本地化并不是你安装过程有问题。如果你想了解某个插件的功能可以先看它的名字、作者、下载量下载量极高的通常是经过社区验证的常用扩展可以放心安装。另一个常见场景尤其是公司电脑或 Windows 系统经过精简、优化工具修改之后Windows 提示“由于出现错误无法启动 Visual Studio Code”并弹出一长串异常段落。这通常是系统缺少某条运行时组件比如 VC 运行库或 .NET 运行时也可能是因为 VSCode 进程没有正常关闭导致用户数据目录被锁定。处理思路很简单先打开任务管理器结束所有 Code.exe 相关进程再以管理员身份重新运行如果仍不行反安装后重启电脑再装一次。这类问题与安装包本身关系不大多为运行环境原因。我遇到过的一个真实案例是用户安装后点击桌面图标一直转圈但窗口不出来排查到最后发现是系统里装了一款老旧的输入法增强工具对“多进程架构”的软件拦截。卸载后 VSCode 立刻恢复正常。所以遇到启动类问题除了检查 VSCode 本身也要回想一下最近装过什么系统级工具。5.3 卸载和重装的干净姿势如果多次尝试仍然无法解决你需要彻底卸载重建一套干净环境。Windows 下正常卸载入口是“设置 应用 已安装的应用”找到 Visual Studio Code 点击卸载。卸载完还要注意VSCode 的用户配置和扩展存储在另外的位置默认路径是 “C:\Users\你的用户名\AppData\Roaming\Code” 和 “C:\Users\你的用户名.vscode”。这两个文件夹不会自动删除。留着它们对下次安装有好处——你的设置、扩展、窗口布局都会恢复。但如果你的问题恰好出在配置或扩展冲突上那就要在卸载后手动删除这两个目录然后再重新安装以达到一个绝对干净的状态。请一定谨慎确认要删除这两处目录它们里面是你全部的个性化设置和已安装扩展删了就没法恢复了。其他项目代码文件不会放在这两个目录里你的实际项目一般存放在自己指定的路径不受影响。重新安装完 VSCode 后再按前面步骤装中文包和扩展就能回到可用状态。整个过程二十分钟以内。踩过几次坑之后我个人的体会是安装和汉化这一关本质上就是一个“下载正确版本、勾对路径选项、装官方语言包、重启确认”的线性流程。绝大多数不顺利都来自两个源头——下载到了非官方封装包以及在附加任务页面漏勾了 PATH、右键菜单这些基础项。与其出了问题再满网搜解决办法不如第一次安装时多花一分钟把选项看清。语言切换这块我已经反复用过很多次中文包安装后基本不用担心崩溃真正需要担心的反而是某些插件和中文字体搭配时渲染效果不理想。这种时候可以去设置里把 “editor.fontFamily” 改成 “微软雅黑, Consolas”字体显示就会圆润很多这也是我最后想分享的一个小技巧。