关键在于显式指定字符集：用InputStreamReader/OutputStreamWriter传入StandardCharsets.UTF_8等编码，避免依赖系统默认编码导致跨平台中文乱码；环境变量传递需编码对齐，敏感内容建议Base64编码。

关键在于用 inputstreamreader 和 outputstreamwriter 显式传入字符集，不依赖系统默认编码。跨系统（如 windows 与 linux）变量解析异常，常源于字节流被错误解码——比如环境变量值含中文时，若未指定编码，jvm 可能用 gbk 解 utf-8 字节，导致乱码或解析失败。

读取含中文的配置变量时指定字符集

当从文件、标准输入或网络流中读取含中文的变量（如 properties 文件、shell 环境导出内容），必须用明确字符集构造 InputStreamReader：

• 读取 UTF-8 编码的配置文件：new InputStreamReader(new FileInputStream("app.conf"), "UTF-8")
• 读取旧版 Windows 导出的 GBK 环境脚本：new InputStreamReader(new FileInputStream("env.bat"), "GBK")
• 推荐使用 StandardCharsets.UTF_8 替代字符串，避免拼写错误和异常抛出

写入变量值到外部系统前统一编码

向 shell 脚本、日志文件或远程服务发送含中文的变量值时，需确保输出流按目标系统预期编码：

• 生成供 Linux 服务器执行的 UTF-8 脚本：new OutputStreamWriter(new FileOutputStream("deploy.sh"), StandardCharsets.UTF_8)
• 写入 Windows 批处理并兼容 CMD：new OutputStreamWriter(new FileOutputStream("run.bat"), "GBK")
• 避免直接用 System.out 输出中文变量——它继承控制台编码，不可控；应包装为带编码的 writer

环境变量传递链中的编码对齐

Java 进程通过 ProcessBuilder 启动子进程时，变量值本身是 String（Unicode），但子进程读取时仍可能因 locale 或 shell 解码逻辑出错：

• 确保子进程启动脚本（如 bash/sh）声明 export LANG=en_US.UTF-8 或对应编码
• 若子进程是 Java 应用，其 System.getProperty("file.encoding") 应与父进程写入时的 OutputStreamWriter 编码一致
• 对敏感变量（如密钥、路径），优先 Base64 编码传输，绕过字符集问题

调试与验证方法

出现变量解析异常时，快速定位是否为编码问题：

• 用 hexdump -C 或 xxd 查看实际写入文件的字节，比对是否符合预期编码规则
• 在读取后立即打印 str.getBytes(StandardCharsets.UTF_8).length 与 str.length()，若差异大，说明已发生解码错误
• 临时将变量值固定为 ASCII 字符串（如 "test123"）测试流程是否正常，可快速排除编码干扰