讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode怎么解决终端中文乱码_VSCode如何修改终端编码解决中文显示异常【详解】

落强吖_5066

落强吖_5066

发布时间:2026-03-28 13:50:31

|

242人浏览过

|

来源于php中文网

原创

根本原因是Windows终端默认GBK编码与工具链UTF-8输出冲突,需统一在VSCode中配置PowerShell UTF-8环境、Git Bash locale及Python IO编码,重启后验证sys.stdout.encoding为utf-8且中文路径正常。

vscode怎么解决终端中文乱码_vscode如何修改终端编码解决中文显示异常【详解】

终端启动时就显示乱码,chcp 切换无效

根本原因不是 VSCode 自身编码设置,而是 Windows 终端(cmd/powershell)默认使用 GBK(代码页 936),而 VSCode 启动的终端进程继承了系统默认页,但 Node.js、Python 等工具链常按 UTF-8 输出中文,导致解码错位。

实操建议:

VSCode
VSCode

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

下载
  • 在 VSCode 设置中搜索 terminal.integrated.defaultProfile.windows,把它设为 PowerShell(比 cmd 更易控制编码)
  • 打开 settings.json,添加:
    "terminal.integrated.profiles.windows": {
      "PowerShell": {
        "source": "PowerShell",
        "args": ["-NoExit", "-Command", "$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = [System.Text.UTF8Encoding]::new()"]
      }
    }
  • 重启 VSCode 终端——此时 chcp 显示仍为 936,但实际 I/O 已强制走 UTF-8,乱码消失

Git Bash 终端里中文路径报错或显示为问号

Git Bash 默认用 UTF-8,但它依赖 Windows 的 LC_ALL 和 LANG 环境变量做 locale 检测;一旦这些变量为空或设成 C,它就会退回到 ASCII 模式,拒绝处理中文路径。

实操建议:

  • 在 VSCode 的 settings.json 中配置:
    "terminal.integrated.env.windows": {
      "LC_ALL": "zh_CN.UTF-8",
      "LANG": "zh_CN.UTF-8"
    }
  • 确保 Git 安装时勾选了 “Enable file system caching” 和 “Use Windows' default console window”,否则即使环境变量正确,底层 msys2 运行时仍可能 fallback
  • 避免在 .bashrc 里手动改 export LANG=C——这是常见踩坑点

Python 脚本 print 中文,在终端里变成 或空格

这不是终端问题,是 Python 解释器启动时没识别到终端支持 UTF-8。Windows 下 Python 3.7+ 默认检查 GetConsoleCP() 和 GetConsoleOutputCP(),而这两个 API 返回的是当前代码页(通常是 936),于是 Python 自作主张把 stdout 编码设为 gbk,和终端真实行为不一致。

实操建议:

  • 临时解决:运行前加环境变量 PYTHONIOENCODING=utf-8,例如:
    set PYTHONIOENCODING=utf-8 & python myscript.py
  • 一劳永逸:在 VSCode settings.json 中加
    "python.defaultInterpreterPath": "C:\path\to\python.exe",
    "terminal.integrated.env.windows": {
      "PYTHONIOENCODING": "utf-8"
    }
  • 注意:不要在脚本里写 sys.stdout.reconfigure(encoding='utf-8')——VSCode 终端下该方法会抛 AttributeError

修改了设置却没生效,echo $LANG 还是空的

VSCode 终端是“新起进程”,它只读取启动那一刻的环境变量;如果在终端里手动 export,只影响当前 shell 实例,新开终端不会继承;同理,修改系统环境变量后,必须完全关闭 VSCode(包括后台进程),再重新打开。

验证是否真正生效的方法:

  • 新开一个集成终端,直接运行:
    python -c "import sys; print(sys.stdout.encoding)"
    → 应输出 utf-8
  • 运行:
    locale
    (Git Bash)或 get-culture(PowerShell)→ 看输出是否含 UTF-8 相关字段
  • 最关键的验证:在项目根目录新建含中文名的文件夹,然后 cd 进去,看路径是否完整显示、无截断或问号
终端编码这事,表面是字符显示,实际牵扯 Windows 控制台 API、shell 初始化流程、语言运行时的编码探测逻辑三层;改一处可能触发另一处 fallback,所以得从启动入口统一收口,而不是在各环节打补丁。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2215

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3542

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1176

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4079

2025.09.10

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3180

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

269

2026.02.03

js正则表达式
js正则表达式

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

4656

2023.06.20

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

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

1395

2023.07.28

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

100

2026.10.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn