当前位置:首页 > 文章列表 > 文章 > python教程 > Python终端中文乱码怎么解决

Python终端中文乱码怎么解决

2026-03-22 17:54:46 0浏览 收藏
Python在Windows CMD终端中输出中文出现问号或方块,本质是CMD默认使用GBK编码而Python脚本按UTF-8处理字符串导致的编码协议冲突,并非字体或Python本身缺陷;最直接有效的临时解法是在运行脚本前执行`chcp 65001`切换为UTF-8代码页,长期兼容方案则可在脚本开头重定向`sys.stdout`为GBK编码(适用于纯CMD环境),而更稳健的跨场景实践是改用PowerShell等原生支持UTF-8的终端,并配合VS Code或PyCharm等IDE的相应编码设置,关键在于确保文件保存、编辑器、Python解释器与终端四者编码链路一致——盯住`chcp`和`sys.stdout.encoding`的实际值,比盲目调试高效得多。

Python终端中文乱码怎么办_CMD控制台编码修改与CHCP设置

Python终端输出中文变问号或方块

根本原因是Windows CMD默认用GBK编码,而Python脚本(尤其带UTF-8 BOM或无BOM但声明了# -*- coding: utf-8 -*-)实际按UTF-8读取和处理字符串,print时字节流被CMD以GBK强行解码,自然出错。

这不是Python bug,也不是字体问题,是编码协议不匹配。临时改CMD窗口属性里的字体(比如设成“Lucida Console”)只能让方块显示成空格,不能恢复文字。

  • 检查当前CMD编码:运行chcp,看到类似活动代码页: 936就是GBK
  • Python 3.7+在启动时会尝试自动适配控制台编码,但仅限于CP65001(即UTF-8),而CMD默认不启用它
  • 直接在脚本开头加sys.stdout.reconfigure(encoding='utf-8')对CMD无效——底层API不支持

用CHCP临时切到UTF-8代码页(最简方案)

在运行Python脚本前,先在CMD中执行:chcp 65001。之后所有print("你好")都会正常显示。

这个操作只影响当前CMD窗口,关掉就失效,适合调试或单次运行。注意不是所有旧版Windows都原生支持65001,Win7需手动开启Unicode支持(注册表项HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage\OEMCP设为65001,但风险高,不推荐)。

  • chcp 65001后,CMD内部使用UTF-8,但部分老命令(如dir中文路径)可能显示异常,属正常现象
  • 如果脚本里用了input(),输入中文也可能乱码——因为stdin同样受chcp影响,此时也得用65001
  • PowerShell不用chcp,它默认UTF-16,但Python启动后仍可能因sys.stdout.encoding误判为cp1252,需额外处理

Python脚本内绕过CMD编码限制(兼容性更强)

不依赖CMD当前代码页,而是把字符串显式编码成GBK再输出——前提是你的终端确实是GBK环境(CMD默认就是)。这样Python和CMD用同一套规则解码。

示例:print("你好".encode('gbk', errors='ignore').decode('gbk'))看似绕,实则稳定。但更实用的是重定向stdout写法:

import sys
import io
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='gbk')

这段必须放在脚本最开头(早于任何print),否则已缓存的输出会失效。

  • 该方法对printlogging、第三方库的print调用都生效
  • 若终端其实是UTF-8(比如WSL、VS Code终端),硬设gbk反而导致乱码——所以它只适合明确知道跑在CMD下的场景
  • 别用sys.setdefaultencoding('gbk'),Python禁止修改默认编码,且该函数在site模块加载后就不可用了

VS Code终端或IDE内乱码怎么处理

VS Code默认终端是PowerShell,但它的python命令常被设成在CMD下启动(看右下角终端类型)。此时chcp 65001依然有效,但更推荐改设置:

打开VS Code设置,搜terminal.integrated.defaultProfile.windows,改成PowerShell;再搜python.defaultInterpreterPath确保指向正确Python。PowerShell本身支持UTF-8,只要Python没主动覆盖sys.stdout.encoding,中文就基本不乱。

  • PyCharm用户请检查Help → Edit Custom VM Options,添加-Dfile.encoding=UTF-8(对Java层有效),但核心仍是确保终端编码与Python一致
  • os.system("chcp 65001 >nul")在脚本开头自动切编码页,能避免手动输命令,但每次运行都闪一下CMD窗口
  • 真正跨平台稳定的方案是:终端用UTF-8(PowerShell/WSL/Terminal.app),Python脚本不指定encoding参数,默认走系统locale——Windows上这反而容易翻车,所以生产环境建议统一用PowerShell + UTF-8

最麻烦的不是改哪里,而是不同环节各自记着不同的编码:文件保存用UTF-8、编辑器显示用UTF-8、Python解释器读文件用UTF-8、CMD却坚持用GBK——只要漏掉一环,乱码就回来。盯住chcp输出和sys.stdout.encoding值,比猜快得多。

到这里,我们也就讲完了《Python终端中文乱码怎么解决》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注golang学习网公众号,带你了解更多关于的知识点!

2025年Yandex入口及访问方式2025年Yandex入口及访问方式
上一篇
2025年Yandex入口及访问方式
Python中inplace函数类型提示详解
下一篇
Python中inplace函数类型提示详解
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • ljg-skills -
    ljg-skills
    ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
    2150次使用
  • MELO音乐 - AI 音乐生成平台,支持多模态创作能力
    MELO音乐
    MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
    1993次使用
  • UniScribe - AI 免费在线音视频转文字平台
    UniScribe
    UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
    1935次使用
  • 剧云 - 免费 AI 智能中文剧本创作平台
    剧云
    剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
    2142次使用
  • 万象有声 - AI 一站式有声内容创作平台
    万象有声
    万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
    2120次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码