如何解决VSCode终端中文乱码但编辑器里中文正常显示的编码冲突

千辰大大_1863

千辰大大_1863

2026-03-26

848人浏览

原创

VSCode终端乱码根源是Windows下PowerShell/cmd默认GBK编码与UTF-8文件不兼容,需按shell类型分别修复:PowerShell配置$PROFILE启用UTF-8、cmd推荐Windows Terminal或chcp 65001、Git Bash检查LANG变量,且终端编码不由VSCode编辑器设置控制。

如何解决vscode终端中文乱码但编辑器里中文正常显示的编码冲突

终端启动时默认编码不是 UTF-8

VSCode 终端(尤其是 Windows 上的 PowerShell 或 cmd)默认可能用 GBK 或 CP936,而你的文件、脚本、Git 输出等是 UTF-8 编码,一读就乱码。编辑器本身走的是文件系统直读 + 自动编码探测,所以显示正常,但终端进程不认 UTF-8 就会崩。

实操建议:

  • 在 VSCode 设置里搜 terminal.integrated.defaultProfile.windows,确认你实际在用哪个 shell(比如 powershell、git-bash、cmd),不同 shell 的修复方式不同
  • PowerShell:必须确保执行 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8,且该命令要在每次启动时运行——加到 $PROFILE 里最稳
  • cmd:改注册表太重,更推荐直接换用 Windows Terminal + 配置 "unicode" : true,或在 VSCode 终端设置里加启动参数:/K chcp 65001 >nul
  • Git Bash:默认已支持 UTF-8,但如果乱码,检查 ~/.bashrc 里有没有 export LANG=zh_CN.GBK 这类覆盖项,删掉或改成 en_US.UTF-8

VSCode 终端继承了系统 locale 而非编辑器编码设置

很多人以为改了 files.encoding 或 files.autoGuessEncoding 就能影响终端,其实完全无关。终端的编码由 shell 进程自身决定,VSCode 只是“窗口”,不干预子进程的 stdout 编码协商逻辑。

常见错误现象:

  • 编辑器里写好中文注释,运行 python script.py 却输出乱码
  • git status 显示中文路径成 \344\273\243\347\256\241 这种八进制转义
  • Python 报错 UnicodeEncodeError: 'gbk' codec can't encode character —— 这说明 Python 检测到 stdout 是 GBK,但你传了 UTF-8 字符

关键点:

  • Python 3.7+ 默认按环境变量 PYTHONIOENCODING 或 sys.stdout.encoding 输出,后者由终端 shell 设定,VSCode 不接管
  • Node.js 同理,process.stdout.encoding 来自终端,不是 VSCode 设置
  • 别在代码里硬写 sys.stdout.reconfigure(encoding='utf-8'),治标不治本,还可能被子进程覆盖

Windows 下 PowerShell 的 $PROFILE 未生效或路径不对

很多人加了 [Console]::OutputEncoding = ... 到 $PROFILE,重启终端还是乱码,本质是 PowerShell 根本没加载那个文件——因为 $PROFILE 有四个可能路径,常用的是 $PROFILE.CurrentUserCurrentHost,但默认不存在,得手动创建。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

实操建议:

  • 在 PowerShell 终端里运行 echo $PROFILE,复制输出路径(通常是 C:\Users\XXX\Documents\PowerShell\Microsoft.PowerShell_profile.ps1)
  • 用 Test-Path $PROFILE 看是否存在;不存在就用 New-Item -Path $PROFILE -Force 创建
  • 用 notepad $PROFILE 打开,粘贴这行:[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
  • 再开新终端,运行 [Console]::OutputEncoding,确认输出是 System.Text.UTF8Encoding
  • 如果仍无效,检查 PowerShell 执行策略:Get-ExecutionPolicy,若为 Restricted,需临时设为 RemoteSigned(Set-ExecutionPolicy RemoteSigned -Scope CurrentUser)

WSL 终端里中文正常,但 VSCode 集成终端却乱码

这是典型「终端复用」陷阱:你在 VSCode 里选的是 WSL,但底层启动方式可能是通过 code . 命令从 Windows 命令行打开的,此时 VSCode 继承了父进程的 Windows locale,而不是 WSL 的 LANG=en_US.UTF-8。

解决重点在启动入口:

  • 不要从 Windows 的 cmd/PowerShell 里执行 code . 启动 VSCode,改用 WSL 内部启动:code . 必须在 WSL 的 bash/zsh 里运行
  • 确认 WSL 中 locale 输出含 UTF-8;若无,编辑 /etc/wsl.conf 加 [boot] command="service locale-gen",或手动 sudo locale-gen zh_CN.UTF-8 并设 LANG=zh_CN.UTF-8
  • VSCode 设置里关掉 terminal.integrated.env.windows 下可能存在的 CHCP 或 LANG 覆盖项
  • 如果用 Remote-WSL 插件,确保它已启用,且 VSCode 左下角显示 “WSL: Ubuntu” 类标识,否则仍是 Windows shell 假装在跑 WSL

真正麻烦的从来不是改哪一行代码,而是搞清当前终端到底是谁启动的、继承了谁的环境变量、又把编码交给了哪个层级去解释。多看一眼 ps -f 或 Get-Process -Id $PID,比反复改配置快得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

4636

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1395

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1818

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10183

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1000

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2904

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1609

5

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

2023.09.21

4989

3

js生成随机数方法
js生成随机数方法

JavaScript生成随机数的方法,包括使用Math.random()方法生成指定范围内的随机整数、生成随机字符串和生成随机颜色。根据具体需求,可以选择适合的方法来生成随机数,以实现各种功能 。

2023.09.25

2895

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程