Mac 的 Docker Desktop 显示英文？一文教你改成中文（超详细）

适用对象：

• macOS 系统语言已是中文，但 Docker Desktop 仍显示英文
• 不想改系统语言，只想让 Docker Desktop 单独显示中文
• 想要一键脚本解决

🔍 1. 先确认你的 Docker Desktop 版本

一般 4.22 及以上 版本都有较完整的中文界面。如果你的版本特别旧，建议先升级再继续。

✅ 2. 最快的尝试：用中文环境变量启动（不改系统设置）

打开「终端」（Terminal）执行：

LANG=zh_CN.UTF-8 open -a "Docker Desktop"

说明：

• 这会用中文语言环境临时启动 Docker Desktop（只对这一次启动生效）。
• 如果这一步已经变中文了，恭喜你可以直接用；
  如果没有生效，继续下一步的「修改配置文件」方法。

🛠 3. 最稳的办法：修改配置文件为中文（永久生效）

第一步：退出 Docker Desktop

• 点击右上角 🐳 图标 → Quit Docker Desktop

第二步：打开配置文件所在目录

在终端执行：

open ~/Library/Group\\ Containers/group.com.docker/DockerDesktop

第三步：找到并编辑 settings.json

• 在打开的文件夹里找到：settings.json
• 用 VS Code 或文本编辑器打开，添加/修改下面这一行（顶层键）：

{
"i18nLocale": "zh-CN"
}

提示：

• 英文是 "en"
• 简体中文是 "zh-CN"
• 如果原来没有 i18nLocale 字段，就新增它；如果有，改成 "zh-CN" 即可。

第四步：保存并重新启动 Docker Desktop

• 重新打开 Docker Desktop，界面应变为中文。

🧨 4. 一键脚本（自动修改为中文 + 备份 + 重启）

如果你不想手改文件，用下面这条一键命令最省事。

osascript -e 'quit app "Docker Desktop"' 2>/dev/null || true && \\
SETTINGS="$HOME/Library/Group Containers/group.com.docker/DockerDesktop/settings.json" && \\
BACKUP="$HOME/Library/Group Containers/group.com.docker/DockerDesktop/settings.json.bak.$(date +%Y%m%d-%H%M%S)" && \\
[ -f "$SETTINGS" ] && cp "$SETTINGS" "$BACKUP" || true && \\
/usr/bin/python3 – <<'PY'
import json, os, pathlib, sys
p = pathlib.Path.home() / "Library/Group Containers/group.com.docker/DockerDesktop/settings.json"
data = {}
if p.exists():
try:
with open(p, "r", encoding="utf-8") as f:
data = json.load(f)
except Exception:
data = {}
data["i18nLocale"] = "zh-CN"
p.parent.mkdir(parents=True, exist_ok=True)
with open(p, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
print("已写入 i18nLocale=zh-CN 到", p)
PY
open -a "Docker Desktop"

它会做什么：

• 自动退出 Docker Desktop
• 备份旧的 settings.json（带时间戳）
• 写入 "i18nLocale": "zh-CN"
• 重新打开 Docker Desktop

♻️ 5. 还原/切回英文怎么做？

方法同上，把值改回 "en" 即可：

osascript -e 'quit app "Docker Desktop"' 2>/dev/null || true && \\
/usr/bin/python3 – <<'PY'
import json, pathlib
p = pathlib.Path.home() / "Library/Group Containers/group.com.docker/DockerDesktop/settings.json"
data = {}
if p.exists():
try:
data = json.loads(p.read_text(encoding="utf-8"))
except Exception:
data = {}
data["i18nLocale"] = "en"
p.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print("已写回 i18nLocale=en 到", p)
PY
open -a "Docker Desktop"

🧹 6. 仍未生效？试试清理偏好缓存后再开

有时偏好缓存会「卡住」旧语言，清理它再开通常能恢复：

osascript -e 'quit app "Docker Desktop"' 2>/dev/null || true
rm -f ~/Library/Preferences/com.docker.docker.plist
open -a "Docker Desktop"

注意：plist 删除的是偏好缓存文件，不会影响镜像、容器或卷数据。

📌 7. 常见问答（FAQ）

Q1：我不想改系统语言，只想 Docker Desktop 是中文，可以吗？
A：可以。用「一键脚本」或手动改 settings.json 的 i18nLocale 即可，不会影响系统语言。

Q2：我的界面还是有少数英文？
A：属于正常现象。新功能/错误提示的翻译可能未完全覆盖，后续版本会逐步完善。

Q3：Docker CLI（命令行）也能变中文吗？
A：不能。CLI 输出设计为英文，不随语言设置变化。

Q4：改完语言会影响容器/镜像吗？
A：不会。只是界面显示语言变更，不影响任何容器、镜像、网络、卷的数据和配置。

Q5：Intel/Apple Silicon（M1/M2/M3/M4）路径是否不同？
A：上述配置路径对两种架构都相同。

✅ 8. 一图总览：三种方法选哪种？

🧭 9. 额外小贴士

• 修改配置失败多半是因为 忘了先退出 Docker Desktop：退出后再改，重开才会读取新配置。
• 如果你在团队里维护多台 Mac，建议把上面的一键脚本收进你的开发环境初始化脚本，省时省心。