CentOS Jenkins如何汉化

在 CentOS 上运行的 Jenkins 进行汉化（中文化），常见且推荐的方式是通过 官方中文插件 实现，而不是修改系统语言。下面按步骤说明。

一、通过 Jenkins 中文插件汉化（推荐 ✅）

1️⃣ 安装中文语言插件

1. 使用浏览器登录 Jenkins
2. 进入：
   Manage Jenkins（系统管理） → Plugins（插件管理） → Available plugins（可选插件）
3. 搜索：

   Localization: Chinese (Simplified)
   

4. 勾选并点击 Install without restart 或 Install and restart

插件名称通常是：

• localization-zh-cn
• 或 Chinese (Simplified) Language Pack

2️⃣ 切换 Jenkins 界面语言为中文

方法一：用户级别设置（推荐）

1. 点击右上角用户名
2. 进入 Configure（配置）
3. 语言选择：

   zh_CN
   

4. 保存后刷新页面

✅ 只影响当前用户，不影响其他用户

方法二：全局设置（不推荐）

1. Manage Jenkins → System
2. 找到 Locale
3. 设置：

   Default Language: zh_CN
   

4. 勾选：

   Ignore browser preference and force this language
   

⚠️ 会影响所有用户

二、CentOS 系统语言是否需要修改？

❌ 不需要

Jenkins 是 Java Web 应用，界面语言由 Jenkins 自身控制，与 CentOS 系统语言无关。

如果你只是想汉化 Jenkins：

• ✅ 不需要修改 CentOS 的 LANG
• ✅ 不需要安装中文系统语言包

三、常见问题

1️⃣ 安装插件后仍然是英文？

多数原因是：

• Jenkins 版本太新，中文插件未完全适配
• 浏览器缓存

✅ 解决方法：

• 强制刷新：Ctrl + F5
• 换一个用户重新登录
• 确认插件已启用

2️⃣ 中文显示乱码？

检查 Jenkins 启动参数：

ps -ef | grep jenkins

确保 JVM 使用 UTF-8：

-Dfile.encoding=UTF-8

如未设置，可在：

/etc/sysconfig/jenkins

中添加或修改：

JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8"

然后重启 Jenkins：

systemctl restart jenkins

3️⃣ 插件名称找不到？

可以尝试：

• 搜索：Chinese
• 或手动下载安装： https://plugins.jenkins.io/localization-zh-cn/

四、总结（最佳实践）

✅ 推荐方案

• 安装 Localization: Chinese (Simplified) 插件
• 使用用户级语言设置 zh_CN
• 不修改 CentOS 系统语言

如果你愿意，我可以：

• 根据你 Jenkins 版本 推荐最合适的汉化方式
• 帮你排查 中文化失败的具体原因