告别乱码：一劳永逸的 VS Code 终端编码统一方案
1. 为什么VS Code终端总是出现中文乱码？
这个问题困扰过几乎所有在Windows上使用VS Code的开发者。明明代码文件保存的是UTF-8编码，调试时终端输出的中文却变成了一堆问号或奇怪的符号。这背后的根本原因在于Windows系统默认编码与开发环境的编码不匹配。
Windows自带的cmd和PowerShell默认使用GBK编码（代码页936），而VS Code默认使用UTF-8编码。当程序输出中文时，终端用GBK解码UTF-8编码的内容，自然就会出现乱码。就像你用英文词典查中文单词，肯定对不上号。
我刚开始用VS Code时也踩过这个坑。记得有次调试一个爬虫程序，打印的中文网页内容全变成了"锟斤拷"这样的乱码，花了大半天才找到原因。后来发现临时输入chcp 65001可以解决问题，但每次开新终端都要重复这个操作，实在太麻烦了。
2. 临时解决方案的局限性
很多开发者遇到这个问题时，第一反应都是搜索"VS Code终端乱码"，然后找到chcp 65001这个命令。确实，这个命令能立即生效：
chcp 65001它把当前终端的代码页改为65001（即UTF-8编码）。但这个方法有三个明显缺陷：
- 临时性：只对当前终端会话有效，关闭后下次打开又得重新输入
- 不彻底：新建的终端标签页或运行新任务时，编码又会恢复默认
- 副作用：某些老旧程序在UTF-8环境下可能出现兼容性问题
我还试过修改VS Code的settings.json，添加：
"terminal.integrated.shellArgs.windows": ["-NoExit", "-Command", "chcp 65001"]这个方法虽然能自动执行命令，但依然不够完美。特别是当项目需要同时使用多个终端时，每个都要单独配置，维护成本很高。
3. 永久修改PowerShell编码的最佳实践
经过多次尝试和踩坑，我发现最彻底的解决方案是修改PowerShell的配置文件。下面是详细步骤：
3.1 创建PowerShell配置文件
首先以管理员身份打开PowerShell，执行：
New-Item $PROFILE -ItemType File -Force这条命令会在你的用户目录下创建（或确认存在）一个PowerShell配置文件，路径通常是：
C:\Users\你的用户名\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps13.2 编辑配置文件
用VS Code或其他文本编辑器打开这个文件（默认是空的），添加以下内容：
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding这行代码做了三件事：
- 设置输出编码为UTF-8
- 设置控制台输入编码为UTF-8
- 设置控制台输出编码为UTF-8
相当于一次性搞定所有编码相关的设置。
3.3 修改执行策略
为了防止脚本执行被阻止，还需要设置执行策略：
Set-ExecutionPolicy Unrestricted -Scope CurrentUser输入命令后按Y确认。这个设置允许当前用户执行本地脚本，不会影响系统安全。
3.4 验证配置
完成后，打开新的PowerShell窗口，输入：
chcp应该会显示"活动代码页：65001"，表示UTF-8编码已生效。现在无论打开多少新终端，编码都会保持UTF-8。
4. 解决常见问题与注意事项
在实际操作中，可能会遇到一些小问题。这里分享几个我踩过的坑和解决方案：
4.1 文件路径包含中文
如果用户目录包含中文，可能会遇到路径问题。这时可以：
- 检查
$PROFILE变量的值是否正确 - 尝试使用英文用户名重新创建配置文件
- 或者直接指定完整路径创建文件：
New-Item "C:\path\to\profile.ps1" -ItemType File -Force4.2 执行策略被拒绝
如果遇到"执行策略"错误，可能是权限问题。可以：
- 确保以管理员身份运行PowerShell
- 尝试更宽松的策略：
Set-ExecutionPolicy Bypass -Scope CurrentUser4.3 与其他工具的兼容性
某些老旧工具可能依赖GBK编码。对于这种情况，可以：
- 临时切换回GBK：
chcp 936 - 或者为特定项目创建单独的配置脚本
5. 为什么这是最佳解决方案？
相比其他方法，这个方案有四个明显优势：
- 全局生效：修改一次，所有终端会话都适用
- 永久有效：重启电脑后设置依然保留
- 不影响系统：只修改当前用户的配置，不会动系统文件
- 兼容性好：与VS Code的UTF-8默认设置完美配合
我团队的所有开发者都采用这个方案后，再也没人抱怨过终端乱码问题。特别是做全栈开发时，前后端控制台输出都能正常显示中文，调试效率提升了不少。
6. 进阶技巧：自动化配置脚本
如果你经常需要配置新电脑，可以把这个过程写成自动化脚本：
# 创建profile目录 if (!(Test-Path -Path (Split-Path $PROFILE))) { New-Item -ItemType Directory -Path (Split-Path $PROFILE) -Force } # 创建profile文件 New-Item $PROFILE -ItemType File -Force # 添加UTF-8配置 Add-Content $PROFILE '$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding' # 设置执行策略 Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force把这个脚本保存为FixEncoding.ps1，新电脑上右键"使用PowerShell运行"就能一键配置了。
7. 其他开发环境的编码统一
除了PowerShell终端，开发中还有其他地方需要注意编码统一：
- 文件保存编码：确保VS Code默认保存为UTF-8
"files.encoding": "utf8" - Git配置：避免中文文件名乱码
git config --global core.quotepath false - 数据库连接：设置正确的客户端编码
这些配置加上终端编码的统一，才能彻底告别中文乱码问题。我在项目中都会把这些写入团队开发规范，新成员按文档配置后就能避免很多不必要的麻烦。