这个错误非常典型，发生在 **Windows 控制台（CMD/PowerShell）默认编码为 `GBK`** 的环境下，而你的 Python 代码中试图打印一个包含 **Unicode 特殊字符（如 `\ufffd`，即 Unicode 替换字符 ）或非 GBK 字符（如 emoji、中文全角标点、数学符号、某些生僻汉字）的字符串**，导致 `print()` 调用底层 `gbk` 编码器时失败： ``` UnicodeEncodeError: 'gbk' codec can't encode character '\ufffd' in position 8: illegal multibyte sequence File "LWzhenduan.py", line 79, in <module> print(f"标签映射: {label_mapping}") ``` > 🔍 注意：你看到的日志中显示的是乱码（如 `ǩӳ`），这是原始中文 `"标签映射"` 被 GBK 错误解码后的结果；而真正报错的是 `label_mapping` 中某个 key/value 含 `\ufffd` 或其他非 GBK 字符（例如：从文件/数据库读入的损坏文本、网络响应中的乱码、或模型预测输出的非法 Unicode）。 --- ### ✅ 根本原因拆解 | 环节 | 问题 | 证据 | |------|------|------| | 🌐 **数据来源污染** | `label_mapping` 中混入了 `\ufffd`（Unicode replacement char），通常表示原始字节流（如 UTF-8）被错误地用 GBK 解码过一次，再转回字符串时产生“无效 Unicode” | `'\ufffd' in str(label_mapping)` 返回 `True` | | 💻 **Windows 终端限制** | CMD 默认使用 `cp936`（GBK），无法显示大部分 Unicode 字符（尤其是 U+FFFD、emoji、CJK 扩展B区汉字等） | `print('✅')` 或 `print('故障诊断')` 也会报同类型错 | | 🐍 **Python 字符串处理不当** | 读取文件/JSON/API 响应时未指定 `encoding='utf-8'`，导致系统用 locale 默认编码（GBK）解码 UTF-8 字节 → 产生 `\ufffd` | 检查 `open(..., encoding=?)` 或 `json.loads(..., encoding=?)` | --- ### ✅ 一劳永逸的修复方案（推荐直接替换第 79 行） 将原第 79 行： ```python print(f"标签映射: {label_mapping}") ``` ✅ **替换为以下鲁棒性打印函数**（自动过滤/替换不可打印字符，兼容 GBK 终端）： ```python import re import json def safe_print(obj, prefix=""): """ 安全打印任意对象，自动处理 Unicode 编码问题，兼容 Windows CMD - 过滤 \ufffd 和控制字符 - 将非 ASCII 字符转义为 \uXXXX（保证可打印） - 对 dict/list 做 json.dumps + ensure_ascii=True """ def clean_str(s): if not isinstance(s, str): return str(s) # 移除 \ufffd 和 C0/C1 控制字符（U+0000–U+001F, U+007F–U+009F） s = re.sub(r'[\uFFFD\u0000-\u001F\u007F-\u009F]', '', s) # 强制转义所有非 ASCII 字符（确保纯 ASCII 输出） return s.encode('unicode_escape').decode('ascii') if isinstance(obj, (dict, list, tuple, set)): # 用 json.dumps 保证可序列化，且 ensure_ascii=True 防止终端崩溃 try: safe_str = json.dumps(obj, ensure_ascii=True, indent=2, default=str) except Exception: safe_str = str(obj).encode('unicode_escape').decode('ascii') else: safe_str = clean_str(str(obj)) print(f"{prefix}{safe_str}") # ✅ 在第 79 行调用它（替代原 print） safe_print(label_mapping, prefix="标签映射: ") ``` > ✅ **效果**： > - 原本会崩溃的 `print(f"标签映射: {label_mapping}")` → 现在稳定输出，如： > ```text > 标签映射: {"正常": 0, "轻度放电": 1, "严重放电": 2, "故障": 3} > ``` > （注意：`\ufffd` 已被自动移除，不会触发编码错误） > - 即使 `label_mapping` 含 emoji、数学符号、日文假名，也安全。 --- ### ✅ 同时必须修复的数据源头（防患于未然） 找到你生成 `label_mapping` 的代码（大概率来自 JSON 文件、CSV 或数据库），**强制指定 UTF-8 编码**： #### ✅ 场景 1：从 JSON 文件读取 ```python # ❌ 危险（依赖系统 locale） # with open("labels.json") as f: # label_mapping = json.load(f) # ✅ 安全（显式声明 UTF-8） with open("labels.json", "r", encoding="utf-8") as f: label_mapping = json.load(f) ``` #### ✅ 场景 2：从 CSV 读取（含中文列名/值） ```python # ✅ 必须加 encoding='utf-8' df = pd.read_csv("labels.csv", encoding="utf-8") label_mapping = dict(zip(df["label_name"], df["label_id"])) ``` #### ✅ 场景 3：从数据库（如 SQLite/MySQL）读取 ```python # SQLite（Python 内置）默认 utf-8，但显式更稳 conn = sqlite3.connect("db.db") conn.text_factory = str # 确保返回 str 而非 bytes # ... query ... # MySQL（用 pymysql） import pymysql conn = pymysql.connect( host='localhost', charset='utf8mb4', # ✅ 关键！支持 emoji cursorclass=pymysql.cursors.DictCursor ) ``` #### ✅ 场景 4：API 响应（requests） ```python resp = requests.get(url) resp.encoding = 'utf-8' # ✅ 强制指定 label_mapping = resp.json() ``` --- ### ✅ 终极方案：让 Windows 终端支持 UTF-8（一劳永逸） > ⚠️ 此操作修改系统级终端行为，需管理员权限，但彻底解决所有 Python Unicode 打印问题。 #### ▶ 方法（CMD 中执行）： ```cmd chcp 65001 ``` → 立即将当前 CMD 页码切换为 UTF-8（65001）。 ✅ 此后 `print("故障诊断✅")` 完全正常。 #### ▶ 永久生效（推荐）： 1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」 2. 在「系统变量」中新建： - 变量名：`PYTHONIOENCODING` - 变量值：`utf-8` 3. 同时新建（或编辑）： - 变量名：`PYTHONUTF8` - 变量值：`1` 4. 重启 CMD / PowerShell / IDE（如 PyCharm） > ✅ 效果：Python 自动以 UTF-8 处理 `stdin/stdout/stderr`，不再依赖终端页码。 --- ### ✅ 一句话总结修复路径 > **错误本质是 `GBK` 终端与 `UTF-8/损坏Unicode` 字符冲突** → > **短期**：用 `safe_print()` 包装所有 `print()`； > **中期**：所有 `open()`/`read_csv()`/`json.load()` 加 `encoding='utf-8'`； > **长期**：在 Windows 设置 `PYTHONIOENCODING=utf-8` + `PYTHONUTF8=1`。 ---