Java ProcessBuilder调用mutt命令处理含非ASCII字符的主题、附件名编码问题

问题根因 #

mutt的编码逻辑完全依赖当前运行环境的locale配置：

• 终端执行时默认加载用户的locale配置（通常为UTF-8），所以主题用UTF-8转base64、附件文件名用UTF-8声明，输出完全正常
• Java ProcessBuilder启动子进程时默认继承JVM的环境变量，若JVM没有显式配置locale，子进程会使用默认的C locale（编码为US-ASCII），mutt识别到当前编码不支持非ASCII字符，就会出现主题编码标记为unknown-8bit、附件文件名声明为us-ascii的问题，最终显示乱码。

解决方案 #

方案1：给ProcessBuilder显式设置UTF-8 locale（优先推荐） #

直接在启动子进程前修改环境变量，无需调整mutt参数，和终端执行逻辑完全一致。
Java代码示例：

ProcessBuilder pb = new ProcessBuilder(
    "mutt",
    "-s", "你的邮件主题",
    "recipient@example.com",
    "-a", "/path/to/你的附件.pdf",
    "-i", "/path/to/邮件内容.txt"
);
// 核心配置：设置子进程的locale为UTF-8
pb.environment().put("LANG", "zh_CN.UTF-8");
pb.environment().put("LC_ALL", "zh_CN.UTF-8");
Process p = pb.start();

提示：如果启动时报locale无效，可在终端执行locale -a查看当前系统支持的所有UTF-8 locale，替换为对应值即可，英文环境也可使用en_US.UTF-8，只要后缀为.UTF-8就生效。

方案2：显式给mutt指定编码配置 #

如果不方便修改子进程环境变量，可以通过mutt的-e参数动态注入编码配置，强制指定编码规则：
构造mutt命令时加入以下参数：

• -e "set send_charset=utf-8"：强制邮件头（包含主题）使用UTF-8编码
• -e "set charset=utf-8"：强制邮件内容默认编码为UTF-8
• -e "set rfc2047_parameters=yes"：强制附件文件名按照RFC2047规范使用UTF-8编码，不会回退到US-ASCII

对应Java ProcessBuilder的参数构造要注意把每个配置拆成单独的参数项，不要拼接引号：

ProcessBuilder pb = new ProcessBuilder(
    "mutt",
    "-e", "set send_charset=utf-8",
    "-e", "set charset=utf-8",
    "-e", "set rfc2047_parameters=yes",
    "-s", "你的邮件主题",
    "recipient@example.com",
    "-a", "/path/to/附件.pdf"
);

校验方法 #

如果调整后还有问题，可以读取子进程的错误输出流查看mutt的运行日志，确认编码配置是否生效，也可以额外加参数-e "set record=/tmp/mutt-out.eml"把发送的原始邮件存档，直接查看邮件头的编码字段是否符合预期。

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