Jenkins任务名含非标中文导致路径错乱，本质是Java文件系统未统一UTF-8编码：需强制JVM参数-Dfile.encoding=UTF-8，配置系统locale为zh_CN.UTF-8，并规范命名禁用emoji/全角标点。
任务名含非标中文导致工作路径拼接错乱，本质是 Jenkins 在创建 Job 目录时，未对文件系统层面的路径名做标准化处理。Linux 文件系统（如 ext4）本身支持 UTF-8 路径，但 Jenkins 的底层逻辑依赖 Java 的 File 类和 JVM 字符编码行为，一旦环境或启动参数未统一为 UTF-8，中文字符就可能被截断、替换为问号、下划线，甚至生成非法字节序列，最终造成目录名损坏、路径解析失败、构建无法进入 workspace 等连锁问题。
确认并统一 JVM 字符编码
Jenkins 启动时若未显式指定文件编码，Java 默认使用系统 locale 的默认编码（如 LANG=C 时为 ASCII），这会导致中文路径名在 Java 层被错误解码。必须强制 JVM 使用 UTF-8：
- 若用
java -jar jenkins.war启动：添加参数-Dfile.encoding=UTF-8，完整命令示例：java -Dfile.encoding=UTF-8 -jar jenkins.war - 若部署在 Tomcat 中：在
catalina.sh（Linux）或catalina.bat（Windows）中添加set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8 - 若用 systemd 管理 Jenkins 服务：在
/etc/systemd/system/jenkins.service的[Service]段添加：Environment="JAVA_OPTS=-Dfile.encoding=UTF-8"，之后执行systemctl daemon-reload && systemctl restart jenkins
确保操作系统 locale 支持 UTF-8
即使 JVM 设置了 UTF-8，若系统 locale 不包含中文 UTF-8 支持（如仅含 en_US），Jenkins 创建目录时仍可能 fallback 到不安全的编码方式：
- 检查当前可用 locale：
locale -a | grep -i "zh\|utf-8"。若无输出，需生成中文 locale（以 CentOS/RHEL 为例）：localectl set-locale LANG=zh_CN.UTF-8或手动执行localedef -c -i zh_CN -f UTF-8 zh_CN.UTF-8 - 验证生效：
locale命令应显示LANG=zh_CN.UTF-8且所有LC_*项均为zh_CN.UTF-8或POSIX - Docker 容器场景：必须在
Dockerfile中显式安装并生成 locale，不能只靠ENV LANG=zh_CN.UTF-8；例如添加：RUN yum install -y glibc-common && localedef -i zh_CN -f UTF-8 zh_CN.UTF-8
避免非标字符，规范任务命名
Jenkins 对 job 名称的合法性校验较宽松，但底层文件系统对路径名有隐式限制（如禁止 NUL、控制字符、过长组合、BOM 等）。非标中文常指全角标点、生僻汉字、emoji、零宽空格等：
- 新建任务时，禁用 emoji、数学符号（如 ①、→）、不可见控制字符（可用编辑器“显示不可见字符”功能检查）
- 优先使用简体中文常用字 + 英文数字 + 连字符（
-）或下划线（_），例如：用户登录模块-接口测试✅，而非：用户登录模块✅接口测试❌ - 已有乱码 job 目录不可直接重命名修复，建议：停用该 job → 备份其
config.xml和构建历史 → 删除 job → 新建同名（合规命名）job → 手动恢复配置与历史（通过复制builds/子目录及更新config.xml中的<displayName>）
验证路径实际生成效果
完成上述配置后，新建一个含标准中文的任务（如“测试-中文路径”），立即检查其物理路径是否正常：
- 进入 Jenkins 主目录（如
/var/lib/jenkins/jobs/），执行：ls -la | grep "测试"，确认目录名完整显示，无?或_替换 - 进入该 job 的
workspace目录，运行pwd和locale，确认当前 shell 环境与 JVM 编码一致 - 在构建步骤中加入 shell 命令：
echo "当前工作区路径: $(pwd)" && ls -la，观察控制台输出是否为可读中文路径
