VPS通过SSH运行含西语字符的Python脚本出现编码报错问题

哪怕系统已经配置es_ES.UTF-8 locale，该问题基本由三个环节的配置不匹配导致，和系统语言包本身无关：

• SSH客户端/传输链路编码不匹配
  本地使用的SSH连接工具（旧版Putty、部分厂商网页控制台、默认配置的低版本Xshell等）如果未强制设置为UTF-8编码，输入ñ这类多字节西语字符时，客户端发送的字节序列和服务端预期的UTF-8编码规则不匹配，会触发终端readline组件解析异常，你看到的(arg: 1)就是字节序列解析失败的典型提示。
  排查操作：连接VPS后先执行echo $LANG $LC_ALL，确认输出为es_ES.UTF-8、未被重置为C/POSIX locale；再执行printf 'ñ' | xxd，正常UTF-8编码下的ñ对应字节为c3b1，如果输出不符合，直接修改SSH客户端的编码配置为UTF-8即可。
• Python解释器未继承系统UTF-8编码配置
  部分精简版VPS镜像、通过snap/容器安装的Python、或者用sudo/crontab方式运行脚本时，环境变量会被重置，Python会 fallback 到ASCII编码读取脚本内容、处理标准输入输出，遇到西语字符就会直接抛出SyntaxError: Non-UTF-8 code或UnicodeEncodeError类报错。
  排查操作：执行python3 -c "import sys; print(sys.getdefaultencoding(), sys.stdout.encoding)"，如果输出包含ascii字段，说明Python侧编码配置异常。临时修复可在运行脚本前指定编码：PYTHONIOENCODING=utf-8 python3 你的脚本路径.py；永久修复可在/etc/environment或当前用户的~/.bashrc中添加export PYTHONIOENCODING=utf-8后重新加载配置。
• 脚本文件本身存储编码非UTF-8
  如果本地编写脚本时用了非UTF-8编码保存（比如Windows西语环境下记事本默认的CP1252编码、旧版编辑器默认的Latin-1编码），哪怕系统和Python都配置为UTF-8，读取脚本时也会出现字符解析错误。
  排查操作：在VPS上执行file 你的脚本路径.py，正常UTF-8编码的脚本会标注UTF-8 Unicode text，如果显示为ISO-8859、CP1252等其他编码，要么将本地文件重新转存为UTF-8格式后重新上传，要么在脚本shebang行下方添加对应编码声明，比如CP1252编码对应# -*- coding: cp1252 -*-。

提示：不要反复重装西语语言包浪费时间，90%以上的同类问题都是SSH客户端编码或Python环境变量配置错误导致。

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