pycharm项目必须全局设为utf-8编码,包括global、project及properties文件编码,并勾选transparent native-to-ascii conversion;已存文件需手动convert to utf-8并添加coding声明;新建文件需配置模板自动插入# -- coding: utf-8 --;还需在运行配置中设置pythonioencoding=utf-8,否则中文仍会乱码或报错。

PyCharm项目默认编码必须设为 UTF-8,否则中文变量名、注释、字符串字面量会直接报 UnicodeDecodeError 或显示乱码——这不是警告,是硬性失败。
File Encodings 里三个编码必须全设成 UTF-8
PyCharm 的编码设置分三层:全局(Global)、项目(Project)、文件级(单个文件右下角)。只要其中一层不是 UTF-8,就可能出问题。
-
Global Encoding:设为UTF-8,影响新打开的无项目文件、VCS 检出文件 -
Project Encoding:设为UTF-8,这是你当前项目的默认编码,最常被忽略但最关键 -
Default encoding for properties files:也设为UTF-8,避免.properties文件读取异常 - 务必勾选
Transparent native-to-ascii conversion(尤其 Windows 用户),否则中文注释可能被转成\u4f60形式
已存在的文件要手动转换,设置不自动生效
改完 File Encodings 后,旧文件仍保持原编码(比如 GBK),右下角显示 GBK 或 GB2312 就说明没转换。不处理,运行时照样崩。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 在 PyCharm 中打开该文件(如
main.py) - 点击窗口右下角当前编码名称(例如
GBK)→ 选Convert to UTF-8 - 弹窗点
Convert(勾选Backup original file更稳妥) - 转换后,立刻在第一行加声明:
# -- coding: utf-8 --或# -*- coding: utf-8 -*- - 保存并重新运行——
SyntaxError: Non-UTF-8 code starting with '\xce'这类错误就消失了
新建 Python 文件自动带 UTF-8 声明
仅靠 File Encodings 设置,不能让新建文件自动含编码声明。必须配置模板,否则每次新建都要手敲。
- 进入
File → Settings → Editor → File and Code Templates - 左侧选
Python Script - 在模板顶部插入一行:
# -- coding: utf-8 -- - 点击
Apply→OK - 之后新建的
.py文件第一行都会自带这行,且 PyCharm 会按 UTF-8 解析整个文件
控制台中文输出仍乱码?还要动 PYTHONIOENCODING
即使文件编码正确,PyCharm 内置终端或 Run 窗口打印中文仍可能是方块或问号——这是 Python 运行时 I/O 编码没对齐。
- 打开
Run → Edit Configurations… - 选中你的运行配置(如
main.py) - 在
Environment variables栏填入:PYTHONIOENCODING=utf-8 - 如果用的是 Windows + cmd/PowerShell,还需确认系统环境变量也设置了
PYTHONIOENCODING=utf-8 - 重启 PyCharm 后再运行,
print("你好")才能正常显示
最容易被跳过的其实是「已存在文件的手动转换」和「运行配置里的 PYTHONIOENCODING」——这两步不做,前面所有设置都白调。尤其团队协作时,别人提交的 GBK 文件,你光改自己设置没用,得一个个转。










