python 3 中 import 异常主因是模块文件非 utf-8 编码且未声明编码，其次为 pythonioencoding 设置错误或终端 locale 不匹配，本质是文件与环境编码协同问题，需四者统一。
直接说结论：Python 3 中因编码导致的 import 异常，90% 是模块文件本身用了非 UTF-8 编码，且未声明；剩下的是环境 I/O 编码不匹配或终端 locale 设置异常。不是 Python 解释器的问题，而是文件和环境的协同问题。
模块文件头部没写 # -*- coding: utf-8 -*-
Python 3 默认按 UTF-8 解析源码，但如果你用编辑器（比如旧版 Notepad、某些 IDE 的默认保存设置）把 .py 文件存成了 GBK 或 ISO-8859-1，解释器读取时就会在解析 import 语句前就抛出 SyntaxError: Non-UTF-8 code starting with...。
- 检查方式：用
file -i your_module.py（Linux/macOS）或chcp+ 手动用记事本另存为确认编码 - 修复方法：在文件第一行或第二行（必须是前两行）加上
# -*- coding: utf-8 -*- - 注意：即使文件里只有 ASCII 字符，只要保存编码不是 UTF-8，这个声明也建议加上——避免跨机器协作时意外出错
PYTHONIOENCODING 环境变量没设或设错
这个变量控制 Python 进程的标准输入输出（sys.stdin/sys.stdout）编码。当模块里有中文注释、docstring 或字符串字面量，且终端 locale 不是 UTF-8（比如 Windows CMD 默认 CP936），就可能触发 UnicodeDecodeError 或 UnicodeEncodeError，尤其在 import 触发 __doc__ 加载或日志打印时。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 临时修复：运行前执行
export PYTHONIOENCODING=utf-8（Linux/macOS）或set PYTHONIOENCODING=utf-8（Windows CMD） - 永久修复：把该变量加入 shell 配置（如
~/.bashrc）或系统环境变量 - 验证是否生效：
python -c "import sys; print(sys.stdout.encoding)"应输出utf-8
终端或 IDE 的 locale 设置与 Python 不一致
Python 启动时会读取系统 locale，若终端 locale 是 zh_CN.GBK 而 Python 试图用 UTF-8 解码路径或错误信息，就可能在导入阶段卡住——特别是路径含中文时，import 失败报错信息本身都显示乱码，掩盖真实原因。
- Linux/macOS：运行
locale查看当前设置，确保LANG和LC_ALL是en_US.UTF-8或zh_CN.UTF-8 - Windows：CMD 中运行
chcp，应为65001（UTF-8）；PowerShell 默认较好，但需确认$OutputEncoding设为UTF8 - PyCharm/VS Code：检查设置里 “Terminal > Encoding” 是否设为 UTF-8，而非 “System default”
真正麻烦的从来不是单点编码设置，而是文件编码、环境变量、终端 locale、IDE 内部编码四者之间任意一对不匹配——它们共同构成一个隐式依赖链。改一处，务必同步验证其他三处，否则问题只是暂时消失。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
