python-gbk-encoding-error.md

title	Python GBK 编码错误 — Windows/WSL 跨平台
domain	devops
tags	python encoding gbk windows wsl

背景

在 WSL 中运行 Python 脚本，读取或写入文件时报：

UnicodeDecodeError: 'gbk' codec can't decode byte ...

或 Cron 日志中出现乱码。

根因

Windows 默认编码是 GBK，WSL 是 UTF-8。当 Python 在 WSL 中读取来自 Windows 的文件或输出日志到挂载盘时，默认编码检测失效。

修复

# 1. 读取文件时显式指定编码
with open("file.txt", "r", encoding="utf-8") as f:
    content = f.read()

# 2. 写入文件时指定编码
with open("file.txt", "w", encoding="utf-8") as f:
    f.write(content)

# 3. 设置环境变量（推荐永久）
# 在 ~/.bashrc 中添加：
export PYTHONIOENCODING=utf-8
export LANG=C.UTF-8

# 4. 对系统日志
sudo locale-gen zh_CN.UTF-8

验证

python3 -c "import sys; print(sys.getdefaultencoding())"
# 应输出 utf-8