GitLab CE 中文界面切换指南（Debian 12）

GitLab 默认界面是英文，但支持多语言，包括 简体中文。本文介绍如何在 Debian 12 上将 GitLab CE 界面切换为中文，包括单用户和批量切换方法。

1️⃣ 单用户切换为中文（Web 界面方式）

1. 登录 GitLab（root 或普通用户）。
2. 点击右上角头像 → Preferences（偏好设置）。
3. 左侧选择 Localization（本地化）。
4. 在 Language 下拉菜单选择 简体中文（Simplified Chinese）。
5. 点击 Save changes 保存。

切换后，该用户的界面就会显示中文。每个用户需要单独设置。

2️⃣ 单用户切换为中文（命令行方式）

如果你想直接通过命令行切换 root 用户语言，无需登录 Web 界面：

sudo gitlab-rails runner "user = User.find_by(username: 'root'); user.update!(preferred_language: 'zh-CN')"

执行完成后，root 用户界面即为简体中文。

如果需要繁体中文，将 'zh-CN' 改为 'zh-TW'。

3️⃣ 批量切换所有用户为中文

在 GitLab 服务器上运行以下命令：

sudo gitlab-rails runner "User.all.each { |u| u.update!(preferred_language: 'zh-CN') }"

⚠️ 注意：

• 这个操作会把所有现有用户的界面语言切换为 简体中文。
• 新注册用户默认语言还是英文，如果需要统一，可在配置文件中设置默认语言（见下一节）。

4️⃣ 设置默认语言为中文（新用户默认）

1. 编辑 GitLab 配置文件：

sudo nano /etc/gitlab/gitlab.rb

2. 添加或修改：

gitlab_rails['default_locale'] = 'zh-CN'

3. 重新应用配置：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

新注册的用户默认界面为中文，已存在用户不受影响。

⚠️ 小提示

• GitLab 的中文界面可能有部分插件或最新功能仍显示英文，这是正常的。
• 如果团队中大部分用户都需要中文，建议同时使用 批量切换 + 默认语言设置。

这样就完成了 GitLab CE 中文界面切换 的完整操作。