写Python脚本处理中文内容时，编码问题常常让人头疼。明明代码在IDE里运行正常，一到命令行执行就满屏乱码或者抛出UnicodeEncodeError。其实这和Python命令启动脚本时采用的执行编码密切相关，搞清楚设置方法就能轻松避开这些坑。
一、Python执行编码到底是什么
很多初学者把文件头的编码声明和脚本运行时的执行编码混为一谈。文件第一行或第二行写的# -*- coding: utf-8 -*-只是告诉Python解释器：读取这个源码文件时请用UTF-8解码，它完全不影响程序启动后往屏幕打印内容用的编码。
真正决定打印结果的叫“标准输入输出编码”，也就是sys.stdout、sys.stdin、sys.stderr的编码。当你在命令行执行python app.py时，解释器会根据操作系统环境猜测这些流的编码。在中文Windows上经常猜成GBK，而你的字符串是UTF-8，冲突就出现了。下面这段简单代码可以查看当前设置：
import sys
print('标准输出编码:', sys.stdout.encoding)
print('标准错误编码:', sys.stderr.encoding)
print('标准输入编码:', sys.stdin.encoding)
运行后如果看到GBK或者cp936，而你的终端实际不支持，那乱码几乎必然发生。理解这一点，我们才能针对性设置执行编码而不是盲目改文件。
二、用环境变量在命令层设置编码
最干净的做法是在启动Python命令前，通过环境变量PYTHONIOENCODING统一规定输入输出编码。这个变量会被解释器读取，并直接应用到标准流上，不需要改动任何源码。在Linux或macOS的bash里可以这样写：
# 临时为本次命令设置UTF-8执行编码 PYTHONIOENCODING=utf-8 python script.py # 或者先导出再运行 export PYTHONIOENCODING=utf-8 python script.py
Windows的cmd中语法稍有不同，使用set命令即可：
set PYTHONIOENCODING=utf-8
python script.py
</p>
<p>这种方式的优点是部署简单，尤其适合写在内网批量执行脚本的bat或sh文件里。缺点是只对当前会话或子进程有效，如果别人直接双击py文件，依然可能用系统默认编码。因此它更适合服务器或固定环境。</p>
<h2>三、在脚本内部重设标准流编码</h2>
<p>如果你希望脚本本身 portable，不管谁用什么命令跑都能正确输出中文，可以在代码入口处重设标准流。Python3.7之后提供了reconfigure方法，比老的重载sys模块方案优雅得多。</p>
<pre class=brush:python;toolbar:false>
import sys
# 程序启动最早的位置调用
if hasattr(sys.stdout, 'reconfigure'):
sys.stdout.reconfigure(encoding='utf-8')
sys.stderr.reconfigure(encoding='utf-8')
print('现在用UTF-8输出中文不会再报错了')
对于更早的版本，可以用io模块重新包装，但代码更啰嗦。reconfigure直接修改缓冲层参数，几乎零成本。注意要在导入其他可能立刻打印的库之前执行，否则前面输出的内容已经用了旧编码。
这种写法的短板是：如果系统终端根本不支持UTF-8显示（极少情况），你强制输出UTF-8字节，屏幕上依旧怪异。不过现代系统基本都兼容，所以它是最常用的兜底方案。
四、源码编码声明与执行编码的区别对照
为了不再混淆，我们用一个表格归纳两者差异，方便排查问题：
| 项目 | 文件编码声明 | 执行编码设置 |
|---|---|---|
| 作用阶段 | 解释器读取源码时 | 程序运行输出输入时 |
| 常用手段 | # coding: utf-8 | PYTHONIOENCODING或reconfigure |
| 影响范围 | 源码字符串字面值解析 | print、input等终端交互 |
| 乱码关联 | 报SyntaxError而非乱码 | 直接决定屏幕显示是否正确 |
从表里能清楚看到，编码声明解决的是“文件读得懂”，执行编码解决的是“屏幕看得懂”。两者配合才算完整。
五、实战：一个兼容多平台的启动命令模板
综合前述方法，我们可以写一个简单的跨平台启动脚本，让Python命令执行时永远使用UTF-8。下面以Windows批处理为例，它先设环境变量再跑主程序：
@echo off setlocal set PYTHONIOENCODING=utf-8 python "%~dp0main.py" %* endlocal
Linux/macOS下则写一个shell包装：
#!/bin/bash export PYTHONIOENCODING=utf-8 exec python3 "$(dirname "$0")/main.py" "$@"
配合源码里的reconfigure，双保险之下，无论用户怎么点、怎么敲命令，中文处理都稳如泰山。这也是许多开源命令行工具默认采用的策略。
六、常见误区与排查清单
最后列出几个高频错误。有人以为改了文件编码声明就能解决输出乱码，结果无效；有人用记事本把py存成UTF-8 BOM，反而让编码声明失效；还有人在IDE里运行正常就以为脚本没问题，忽略真实命令行环境。排查时建议按顺序确认：源码是否无BOM的UTF-8、启动命令是否带PYTHONIOENCODING、脚本是否重设stdout、终端本身字体是否支持中文。
只要按上述步骤逐一对照，Python命令设置脚本执行编码就是一件轻松的事。把环境理顺之后，你就能把精力放在业务逻辑而不是和乱码搏斗上。