告别乱码：一劳永逸配置 VS Code 终端为 UTF-8 编码

最新推荐文章于 2026-04-07 16:10:59 发布

原创

最新推荐文章于 2026-04-07 16:10:59 发布 · 1.4k 阅读

1. 为什么你的 VS Code 终端总在“说火星文”？

不知道你有没有遇到过这种情况：在 Windows 上打开 VS Code，兴致勃勃地运行一段代码，结果终端里本该显示的中文，却变成了一堆像“锟斤拷烫烫烫”或者“口口口”这样的乱码。这感觉就像你满怀期待地打开一封重要邮件，结果发现里面全是看不懂的符号，瞬间让人头大。

这个问题，我敢说，几乎每个在 Windows 上用 VS Code 的开发者都踩过坑。我自己也不例外，早期被这个问题折腾得够呛。你可能会想，是不是我的代码写错了？或者 VS Code 版本有问题？其实，问题的根源往往不在 VS Code 本身，而在于它背后那个“沉默的搭档”——终端（Terminal）的默认编码设置。

简单来说，编码就像翻译官。你的代码文件（通常是 UTF-8 编码）用中文写了“你好，世界”，但终端这个“翻译官”如果只会说“GBK”这种方言，那它翻译出来的结果自然就是一堆乱码。VS Code 默认使用 UTF-8 编码来保存和读取文件，这是国际通用的标准，但 Windows 系统自带的 PowerShell（特别是旧版本）在默认情况下，却可能还在使用 GBK（或 GB2312）这样的本地编码。这种“鸡同鸭讲”的局面，就是乱码产生的根本原因。

网上流传着很多临时解决方案，比如在终端里输入 chcp 65001 命令。这个方法确实立竿见影，因为它临时把当前终端会话的代码页切换成了 UTF-8（65001 就是 UTF-8 的代码页编号）。但它的致命缺点是“一次性”的。只要你关闭这个终端标签页，或者重启 VS Code，新打开的终端又会变回老样子，乱码依旧。这就像每次进门都要找钥匙，而不是直接换一把永久的智能锁。

更激进的方法是在 Windows 系统区域设置里强制使用 UTF-8，但这被很多老手戏称为“杀敌一百，自损一万”。因为它可能影响一些陈旧的、依赖特定编码的本地化软件，导致它们运行异常，风险太高。所以，我们今天要做的，不是这种全局性的“大手术”，而是针对 PowerShell 这个 VS Code 默认终端候选者，进行一次精准、永久且安全的“编码矫正手术”，让你从此和乱码说再见。

2. 第一步：让 VS Code 认准 PowerShell 这个“好搭档”

在动手修改编码之前，我们得先确保 VS Code 正在使用我们想要改造的那个终端。VS Code 非常灵活，它允许你在多种终端之间切换，比如传统的命令提示符（CMD）、Windows PowerShell、PowerShell Core（现在叫 PowerShell 7）甚至 Git Bash。为了统一管理和配置，我强烈建议你将默认终端设置为 Windows PowerShell。这是 Windows 系统自带的，也是我们后续配置生效的基础。

为什么是 PowerShell 而不是 CMD？因为 PowerShell 功能更强大，对现代开发更友好，而且微软也在逐渐将重心向它倾斜。更重要的是，我们接下来要做的永久性 UTF-8 配置，在 PowerShell 上实现起来更优雅、更可靠。

操作步骤非常简单，跟着我做：

打开命令面板：这是 VS Code 的“万能控制台”。使用快捷键 Ctrl+Shift+P（在 Mac 上是 Cmd+Shift+P），窗口顶部会弹出一个输入框。
选择默认终端：在命令面板里，开始输入 Select Default Profile。你会看到选项列表里出现“终端：选择默认配置文件”。用键盘上下键选中它，然后按回车。
指定 PowerShell：紧接着，VS Code 会列出你系统上