讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Python 字符编码问题产生的根本原因

云瑶吖_3761

云瑶吖_3761

发布时间:2026-02-14 19:56:02

|

695人浏览过

|

来源于php中文网

原创

Python 2的str是字节序列,Python 3的str是Unicode字符串,这是编码错误的根源;读写文件须显式指定encoding="utf-8",避免依赖默认locale;终端、网络、数据库各层编码需单独校验并保持一致。

python 字符编码问题产生的根本原因

Python 2 和 Python 3 的 str 类型本质不同

Python 2 的 str 是字节序列,Python 3 的 str 是 Unicode 字符串——这是绝大多数编码错误的起点。不是“没设编码”,而是你默认在拿 Python 3 当 Python 2 用。

常见错误现象:UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe4 in position 0,或中文显示成 \xe4\xbd\xa0\xe5\xa5\xbd。

  • 读文件时没指定 encoding 参数(Python 3 默认用系统 locale,Windows 常是 cp936,Linux 常是 utf-8)
  • 用 str(byte_string) 强转字节对象(Python 3 中这会调用 __str__,不是解码)
  • 混用 bytes 和 str 做拼接,比如 b"hello" + "world"

open() 不加 encoding 就等于开盲盒

Python 3 的 open() 默认使用 locale.getpreferredencoding(),它不等于文件实际编码,也不等于你编辑器保存的编码。

使用场景:读写配置、日志、用户提交的文本文件。

立即学习“Python免费学习笔记(深入)”;

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 明确写死 encoding="utf-8",除非你确定文件是 GBK(如 Windows 记事本旧版保存)
  • 写文件时也必须加 encoding,否则 print(..., file=f) 可能因默认编码不匹配而报错
  • 遇到乱码先用 chardet.detect() 猜编码,但别依赖它自动解码——它只是启发式估算

示例:with open("data.txt", encoding="utf-8") as f: content = f.read()

sys.stdout.encoding 和终端实际支持的编码经常对不上

Python 启动时会从环境推断 sys.stdout.encoding,但 Windows CMD、PowerShell、IDE 内置终端、SSH 连接各自有一套编码逻辑,print() 出来的是什么,取决于三者是否一致:Python 推断出的编码、终端当前代码页、字符串本身是否已正确解码。

常见错误现象:脚本里 print("你好") 在 PyCharm 正常,在 CMD 报错;或者输出是问号或方块。

  • Windows 上 CMD 默认是 cp936,但 Python 可能设成 utf-8,这时需手动改终端:执行 chcp 65001
  • 不要用 sys.setdefaultencoding() —— 它只在启动初期有效,且强行修改会掩盖真实问题
  • 如果必须兼容老旧终端,把输出先 encode 成目标编码再 write 到 sys.stdout.buffer

HTTP 响应、JSON、数据库字段的编码要单独校验

网络和存储层不认 Python 的字符串抽象,它们只认字节流。你以为传的是字符串,其实中间已经过一次隐式编码/解码。

使用场景:调用 API、存 MySQL、解析 JSON 返回体。

  • requests.get().text 依赖响应头的 charset,若缺失或错误,结果就是乱码;更稳的方式是用 .content.decode("utf-8") 显式控制
  • MySQL 的 CHARSET=utf8mb4 和连接参数 charset="utf8mb4" 必须同时设置,缺一不可
  • JSON 只接受 Unicode 字符串,json.loads() 输入必须是 str,不能是 bytes;而 json.dumps() 输出默认是 str,想得字节要用 ensure_ascii=False + .encode()
真正卡住人的,往往不是“怎么设 utf-8”,而是某一层悄悄用了别的编码,还假装自己很统一。比如数据库连的是 utf8mb4,但 SQLAlchemy 的 create_engine 没传 charset,或者 Nginx 反向代理时加了错误的 charset 头。查的时候得一层层确认字节进来时是谁解的码。

热门AI工具

更多
WorkBuddy

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

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

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

UpDream
UpDream Hot

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

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2553

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1539

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

915

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3652

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

6328

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1339

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6591

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

5642

2023.08.14

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

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

精品课程

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

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