如何在Docker容器中为Python正确配置UTF-8本地化环境？

你的问题核心在于：PYTHONIOENCODING仅控制Python标准输入输出的编码，而open()函数的默认编码由系统locale的preferred encoding决定——即使容器显示locale为C.UTF-8，Python 3.6对这个locale的兼容处理可能存在疏漏，导致默认编码未正确设为UTF-8。以下是几种彻底解决的方案：

1. 完整配置容器的UTF-8 Locale #

C.UTF-8是轻量级POSIX兼容locale，但Ubuntu 16.04下Python 3.6更倾向于识别完整的区域locale（如en_US.UTF-8）。可以通过以下步骤配置：

• 启动容器时执行locale初始化命令（或写入自定义Dockerfile）：

  # 安装locale生成工具并生成en_US.UTF-8
  apt-get update && apt-get install -y locales && locale-gen en_US.UTF-8
  

• 启动容器时添加完整的locale环境变量：

  docker run -e PYTHONIOENCODING=utf-8 -e LC_ALL=en_US.UTF-8 -e LANG=en_US.UTF-8 nvidia/pytorch:19.05
  

  配置后，执行python -c "import locale; print(locale.getpreferredencoding(False))"应该返回UTF-8。

2. 强制Python全局默认编码为UTF-8 #

对于Python 3.6，可以通过全局配置让所有脚本默认使用UTF-8打开文件：

• 在容器的Python site-packages目录（如/usr/local/lib/python3.6/site-packages/）创建sitecustomize.py文件，内容如下：

  import sys
  # 重载sys模块以应用默认编码修改
  if sys.version_info >= (3, 0):
      import importlib
      importlib.reload(sys)
  sys.setdefaultencoding('utf-8')
  

  这个文件会在所有Python进程启动时自动加载，强制将默认编码设为UTF-8。

3. 验证环境变量生效 #

启动容器后，执行以下命令确认编码配置：

# 检查系统locale
locale
# 检查Python默认编码
python -c "import sys; print(sys.getdefaultencoding())"
python -c "import locale; print(locale.getpreferredencoding(False))"

如果两个Python命令都返回UTF-8，说明配置生效，此时open()函数无需手动指定encoding="utf-8"也能正确处理UTF-8文件。

补充说明 #

PYTHONIOENCODING仅负责stdin/stdout/stderr的编码，和文件打开的默认编码无关。而C.UTF-8虽然是合法的UTF-8 locale，但在旧版Python（3.6）中，locale.getpreferredencoding()可能不会正确返回UTF-8，改用完整的区域locale（如en_US.UTF-8）能避免这个兼容性问题。

内容的提问来源于stack exchange，提问作者Yy X