VS Code终端乱码：是什么，为什么，以及如何解决
在使用Visual Studio Code (VS Code) 进行开发时，集成终端是一个非常方便的工具。然而，许多用户都曾遇到过一个令人沮丧的问题：终端中显示的内容出现乱码，特别是中文、日文等非ASCII字符。这些乱码通常表现为一串无意义的符号或问号。这极大地影响了命令输出的可读性，也给开发过程带来了不便。
本文将围绕VS Code终端乱码这一现象，深入探讨其产生的原因、涉及的设置位置，并提供详细具体的解决方案，帮助你彻底告别乱码困扰。
【是什么】VS Code终端乱码具体表现
终端乱码通常指在VS Code的集成终端中，本应显示为正常文字（如中文）的地方，却显示成了一些无法识别的符号，例如：
??或???□□- 一系列奇怪的、不连续的符号或方框
- 在执行某些命令（如
git status、程序输出、文件列表ls/dir等）时，文件名或信息中的非英文字符变成乱码。
这种问题只影响文本显示，通常不会影响命令的实际执行，但会使得终端的输出难以理解和使用。
【为什么】VS Code终端乱码的根本原因
乱码问题的核心几乎总是出在字符编码（Encoding）上。简单来说，计算机存储和显示文字都需要遵循一定的编码规则。当信息的发送方（比如一个程序或操作系统）使用一种编码，而接收方（VS Code终端）使用另一种不兼容的编码来解释这些信息时，就会出现乱码。
在VS Code终端的环境中，涉及到多个层面的编码：
-
操作系统的区域设置 (Locale) 和默认编码
操作系统（Windows, macOS, Linux）有自己的默认语言和区域设置，这决定了许多系统工具和程序的默认编码。在中文Windows系统中，传统的默认编码可能是GBK（或GB2312），而在现代系统中或Linux/macOS中，UTF-8更为普遍。如果终端或程序期望的是UTF-8，而系统默认是GBK，就可能产生冲突。
-
VS Code集成终端的编码设置
VS Code允许你为集成终端设置编码。这个设置告诉VS Code如何解释从终端进程接收到的字节流。如果VS Code的终端编码设置与终端实际运行的Shell（如PowerShell, Cmd, Git Bash）或输出内容的程序的编码不一致，就会导致乱码。
-
终端Shell自身的编码设置
不同的Shell有自己的编码管理方式。例如，Windows的Cmd和PowerShell有自己的代码页（Code Page，用
chcp命令查看和修改），而Git Bash（基于MinGW/MSYS）或Linux/macOS的Bash/Zsh等则受Locale环境变量（如LANG,LC_ALL）影响。如果VS Code的设置与Shell的实际运行编码不匹配，或者Shell自身的编码设置就有问题，也会引发乱码。 -
被执行程序的输出编码
某些程序在输出信息时，可能会硬编码使用特定的编码（例如，老旧的程序可能只使用GBK）。如果终端期望的是UTF-8，而程序输出的是GBK，乱码就会发生。这种情况相对少见，且解决起来可能需要在程序层面或通过转码工具。
-
字体支持问题（相对少见）
在极少数情况下，终端使用的字体可能不包含显示某些特定字符所需的字形，这也会表现为方框或其他替代符号，类似于乱码。但这通常只会影响少数特殊字符，而不是大面积的中文乱码。
总结来说，VS Code终端乱码的根本原因在于：
终端显示器（VS Code）期望的编码 ≠ 终端进程（Shell）实际运行的编码 ≠ 输出内容的程序使用的编码
其中最常见和最容易解决的是前两者的不匹配。
【哪里】乱码相关设置的位置
要解决VS Code终端乱码，你需要检查和修改以下几个地方的设置：
-
VS Code用户设置或工作区设置
这是最主要的设置位置。通过VS Code的设置界面（文件 -> 首选项 -> 设置 或 Code -> 首选项 -> 设置），搜索与终端相关的设置项。核心设置项在
terminal.integrated类别下。 -
操作系统的区域和语言设置
影响系统默认编码和Locale。例如，Windows的“区域设置”（控制面板或设置应用中）中的“语言用于非Unicode程序”选项。
-
特定Shell的配置文件或启动命令
有些Shell（如Git Bash）可以通过其启动参数或配置文件来强制编码。
【多少】可能需要修改的设置项数量及场景
通常情况下，解决VS Code终端乱码可能只需要修改1到3个关键的VS Code设置项。具体取决于你使用的操作系统和默认的Shell。
你需要考虑以下几种不同的场景：
- Windows系统使用Cmd或PowerShell作为默认终端。
- Windows系统使用Git Bash或WSL (Windows Subsystem for Linux) 作为默认终端。
- macOS或Linux系统，通常默认就是Bash或Zsh。
- 乱码只在运行特定程序时出现。
大多数情况下，通过正确配置VS Code的终端配置文件（Profiles）和默认终端编码就能解决问题。
【如何/怎么】详细的解决方案步骤
解决VS Code终端乱码的核心思路是：确保VS Code终端、你使用的Shell以及操作系统尽可能都使用一致的编码，通常推荐使用UTF-8。
以下是详细的步骤：
-
检查和修改VS Code的终端配置文件 (Profiles)
这是最常用且有效的解决方法。VS Code允许你为不同的终端Shell定义独立的配置，包括启动命令和编码。
打开VS Code设置（
Ctrl+,或Cmd+,），搜索terminal.integrated.profiles。你会看到一个针对不同操作系统的子设置，例如terminal.integrated.profiles.windows。点击“在 settings.json 中编辑”或通过设置界面修改。在这个设置中，找到你常用的Shell（如
PowerShell,Command Prompt,Git Bash,WSL等）对应的配置项。你需要给它添加或修改args（启动参数）或env（环境变量）来强制其使用UTF-8编码。a) 对于Windows Command Prompt (cmd.exe):
Cmd默认使用的是系统代码页，中文系统通常是GBK (代码页 936)。要强制其使用UTF-8 (代码页 65001)，可以在启动时执行chcp 65001命令。在
settings.json中，找到或添加 Cmd 的配置，修改args：
"terminal.integrated.profiles.windows": {
"Command Prompt": {
"path": ["${env:windir}\\System32\\cmd.exe", "${env:windir}\\SysWOW64\\cmd.exe"],
"args": ["/k", "chcp 65001"]
},
// ... 其他 profiles ...
}
这里的/k chcp 65001表示执行chcp 65001命令后保留窗口（而不是执行完就关闭）。b) 对于Windows PowerShell (powershell.exe):
PowerShell 的编码受多个因素影响，通常与系统Locale相关。可以在启动时设置环境变量或执行命令。设置环境变量$OutputEncoding和[Console]::OutputEncoding是常见方法。在
settings.json中，找到或添加 PowerShell 的配置，修改args：
"terminal.integrated.profiles.windows": {
"PowerShell": {
"path": ["${env:windir}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"],
"args": ["-NoExit", "-Command", "[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; $OutputEncoding = [System.Text.Encoding]::UTF8;"]
},
// ... 其他 profiles ...
}
或者，更推荐的方式是在用户或工作区设置中直接为所有PowerShell实例设置环境变量：
搜索terminal.integrated.env.windows，并添加以下内容：
"terminal.integrated.env.windows": {
"PYTHONIOENCODING": "utf-8",
"PSExecutionPolicyPreference": "Bypass" // 如果有执行策略问题可能需要
},
并在 PowerShell profile 中执行编码设置。或者尝试修改 PowerShell 的启动脚本（通常在$PROFILE路径）。
更直接可能是在 profile 定义中设置环境变量env（但这主要影响进程启动时的环境变量，对PowerShell内部编码控制可能不如直接执行命令有效）：
"terminal.integrated.profiles.windows": {
"PowerShell": {
"path": "powershell",
"env": {"LANG": "en_US.UTF-8", "LC_ALL": "en_US.UTF-8"} // 尝试使用类似Linux的方式
},
// ...
}
实际测试发现，在PowerShell Profile启动时执行[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; $OutputEncoding = [System.Text.Encoding]::UTF8;是更可靠的方法。因此修改args如第一个例子可能更有效。c) 对于Git Bash (bash.exe):
Git Bash 基于 MinGW/MSYS，其编码主要受 Locale 环境变量（LANG,LC_ALL,LC_CTYPE等）影响。确保这些变量设置为 UTF-8 相关的区域设置。在
settings.json中，找到或添加 Git Bash 的配置，添加或修改env：
"terminal.integrated.profiles.windows": {
"Git Bash": {
"path": "C:\\Program Files\\Git\\bin\\bash.exe", // 请根据你的安装路径修改
"args": [],
"env": {"LANG": "en_US.UTF-8", "LC_ALL": "en_US.UTF-8"}
},
// ... 其他 profiles ...
}
或者，更直接的设置是在用户或工作区设置中：
搜索terminal.integrated.env.windows，并添加或修改环境变量：
"terminal.integrated.env.windows": {
"LANG": "en_US.UTF-8",
"LC_ALL": "en_US.UTF-8"
},
d) 对于WSL (Windows Subsystem for Linux):
WSL环境下的乱码通常是Linux环境的Locale问题，以及Windows终端与之交互的问题。首先确保你的WSL发行版内部Locale是UTF-8。然后确保VS Code的WSL profile配置正确。在
settings.json中，找到或添加 WSL 的配置。通常不需要额外的args或env，因为VS Code对WSL支持较好，主要依赖WSL自身的Locale设置。
"terminal.integrated.profiles.windows": {
"WSL": {
"path": "C:\\WINDOWS\\sysnative\\wsl.exe"
},
// ... 其他 profiles ...
}
如果在WSL内部出现乱码，你需要登录到WSL环境内部，检查并设置Locale：
执行命令locale查看当前Locale设置。
如果不是UTF-8，修改Locale设置。对于基于Debian/Ubuntu的系统：
sudo locale-gen en_US.UTF-8 zh_CN.UTF-8
sudo dpkg-reconfigure locales
选择你需要的UTF-8 Locale，并设置为默认。或者手动修改/etc/default/locale文件。e) 对于macOS/Linux:
macOS和绝大多数现代Linux发行版默认已经使用UTF-8作为系统编码，因此VS Code终端通常不会出现乱码。如果出现，首先检查系统的Locale设置：
打开终端，执行locale命令。确认LANG,LC_CTYPE,LC_ALL等变量包含 “UTF-8″。
如果Locale不正确，修改系统设置或相应的Shell配置文件（如~/.bashrc,~/.zshrc）来设置这些环境变量：
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
然后在VS Code中重启终端。 -
设置VS Code的默认终端编码
除了为特定的Profile设置编码，VS Code还有一个全局的终端编码设置。
打开VS Code设置，搜索
terminal.integrated.encoding。将其设置为utf8。这个设置是一个回退选项，但在某些情况下直接设置它也能解决问题。不过，更推荐通过Profile的args或env来让Shell自身使用UTF-8。在
settings.json中：
"terminal.integrated.encoding": "utf8"
-
设置VS Code的默认终端 (Default Profile)
确保你修改了设置的那个Profile是你实际使用的默认Profile。
打开VS Code设置，搜索
terminal.integrated.defaultProfile。针对你的操作系统（如terminal.integrated.defaultProfile.windows），选择你已经配置好编码的Profile，例如“Command Prompt”、“PowerShell”或“Git Bash”。在
settings.json中：
"terminal.integrated.defaultProfile.windows": "Command Prompt" // 或者 "PowerShell", "Git Bash"
-
检查及修改系统Locale设置（Windows用户尤其重要）
对于Windows用户，如果频繁遇到乱码，可能需要检查系统的非Unicode程序语言设置。
- 打开“控制面板” -> “区域”。
- 切换到“管理”标签页。
- 在“非 Unicode 程序的语言”部分，点击“更改系统区域设置”。
- 如果当前设置为“中文(简体, 中国)”，这通常意味着非Unicode程序默认使用GBK。为了更好的兼容性（尤其是与UTF-8终端），可以考虑勾选“Beta 版：使用 Unicode UTF-8 提供全球语言支持”。
注意：勾选此选项需要重启电脑，且这是一个Beta功能，理论上可能对某些非常老的、依赖特定代码页的程序造成兼容问题，但对于现代应用和终端使用UTF-8是非常推荐的。
-
检查终端字体设置
虽然不常见，但如果字体不支持，也会导致某些字符无法显示。
打开VS Code设置，搜索
terminal.integrated.fontFamily。确保你选择的字体是支持中文等字符的，例如Consolas, Cascadia Mono, Sarasa Term SC (更纱黑体) 等。在
settings.json中：
"terminal.integrated.fontFamily": "Consolas, 'Courier New', monospace" // 确保包含支持中文的字体
或者指定一个明确支持中文的字体：
"terminal.integrated.fontFamily": "'Sarasa Term SC', Consolas, 'Courier New', monospace"
【如何】验证和调试
-
重启VS Code
修改设置后，最好关闭VS Code并重新打开，确保新的终端实例加载了最新的配置。
-
在新终端中验证
打开一个新的VS Code集成终端。执行一些会输出中文的命令，比如
dir(在中文目录下),git status(如果文件名含中文), 或者一个简单的 Python 脚本print("你好世界")。 -
在终端中检查当前编码
在出现乱码的终端中，尝试执行命令检查当前Shell的代码页或Locale：
对于Cmd：执行chcp，看是否显示活动代码页 65001 (UTF-8)。
对于PowerShell：执行[Console]::OutputEncoding和$OutputEncoding，看是否显示 UTF8。
对于Git Bash/WSL/Linux：执行locale，看LANG或LC_ALL是否包含 UTF-8。
如果检查结果不是UTF-8，说明你的配置修改没有生效，需要仔细检查步骤1中的Profile设置是否正确应用到了你当前的默认终端。 -
尝试切换终端Profile
如果配置了多个Profile，尝试切换到你认为配置正确的Profile，看看问题是否解决。VS Code终端右上角有一个下拉箭头，可以切换终端类型。
总结
VS Code终端乱码问题通常是由于VS Code终端、操作系统、Shell以及被执行程序之间的编码设置不一致造成的。通过优先将各个环节统一到使用UTF-8编码，可以有效解决绝大多数乱码问题。最主要的解决手段是配置VS Code的终端Profiles，特别是针对Windows系统下的Cmd和PowerShell，需要额外的启动参数或环境变量来强制使用UTF-8。同时，检查系统的Locale设置和终端字体也能作为补充的排查方向。耐心按照步骤检查和修改相关设置，通常都能根除乱码烦恼。
