<p>PyCharm项目必须全局设为UTF-8编码，包括Global、Project及Properties文件编码，并勾选Transparent native-to-ascii conversion；已存文件需手动Convert to UTF-8并添加coding声明；新建文件需配置模板自动插入# -- coding: utf-8 --；还需在运行配置中设置PYTHONIOENCODING=utf-8，否则中文仍会乱码或报错。</p>
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
下载
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 文件，你光改自己设置没用，得一个个转。
