如何 5 分钟装好 Zed 中文版：zed-globalization 跨平台安装教程（macOS/Windows/Linux 全收录）

• 开发工具
• 国际化
• AI 应用
• CLI

zed-globalization是 Zed 编辑器的汉化版 / 中文版 / 多语言版，由 AI 驱动的全自动翻译流水线构建，支持简体中文、繁体中文、日语、韩语，开箱即用。本教程覆盖 macOS（Homebrew / DMG）、Windows（Scoop / 安装向导）、Linux（deb / rpm / tar.gz）三大平台的最快安装方法，5 分钟即可完成 Zed 中文版安装。

安装包怎么选：一张表看懂 Zed 中文版下载清单

Zed 中文版（构建产物名为ZedG）为每个平台都提供了预编译包，无需自己编译：

👉 选择建议：macOS 用户用 Homebrew，Windows 用户用 Scoop，Linux 用户优先选 deb 或 rpm 包（自动注册桌面入口和图标），都是两条命令搞定。

macOS 安装：Homebrew 一键安装（最快配置方法）

打开「终端」，执行以下命令：

# 首次安装 brew tap x6nux/zedg brew install --cask zedg # 以后手动更新 brew update && brew upgrade --cask zedg

Homebrew 会根据你的芯片架构（Apple Silicon / Intel）自动选对安装包。想尝鲜可以安装预览版：brew install --cask zedg-preview。

DMG 手动安装（不装 Homebrew 的替代方案）：

1. 从项目 Releases 页下载zedg-zh-cn-macos-universal-*.dmg
2. 打开后将 ZedG 拖入 Applications
3. 首次打开若提示"应用已损坏"（因构建未经 Apple 签名），执行一条命令即可解决：

sudo xattr -rd com.apple.quarantine /Applications/ZedG.app

Windows 安装：Scoop 命令行安装（推荐）

打开 PowerShell，执行：

# 首次安装 scoop bucket add zedg https://github.com/x6nux/scoop-zedg scoop install zedg # 手动更新 scoop update zedg

zedg与zedg-compat怎么选？

• zedg— 只注册zedg命令，不影响已安装的官方 Zed（✅ 推荐）
• zedg-compat— 额外注册zed命令，git difftool、终端zed .等生态工具会自动把 ZedG 识别为默认编辑器

两种方式可随时切换：scoop uninstall zedg && scoop install zedg-compat。

传统安装向导（NSIS 安装包）：双击ZedG-Setup.exe按向导走即可，安装包的组件页可勾选「覆盖官方 Zed 安装」——它会自动备份官方zed.exe再替换，卸载时自动还原，互不破坏。安装包逻辑见 packaging/windows/zedg-setup.nsi。

Linux 安装：deb / rpm / tar.gz 三种方式

Debian / Ubuntu 系（deb 包）：

sudo dpkg -i zedg-zh-cn-linux-x86_64-*.deb

Fedora / RHEL 系（rpm 包）：

sudo dnf install zedg-zh-cn-linux-x86_64-*.rpm

通用方式（tar.gz 解压）：

sudo tar -xzf zedg-zh-cn-linux-x86_64-*.tar.gz -C /usr/local

deb / rpm 包会自动注册zedg.desktop桌面入口和应用图标（关联text/plain），应用列表里直接可见。包内文件布局可参考 packaging/deb/DEBIAN/control 和 packaging/rpm/zedg.spec。

可选进阶：让系统把 ZedG 当作zed（生态兼容开关）

git difftool、「默认编辑器」选择器通常只找名为zed的命令。ZedG 提供了一键激活脚本 scripts/zedg-activate.sh，不破坏官方 Zed 安装，可随时还原：

zedg-activate.sh # 激活：创建 ~/.local/bin/zed 链接 + 注册 desktop 入口 zedg-activate.sh --status # 查看当前接管状态 zedg-activate.sh --revert # 一键还原官方状态

Windows 用户则通过安装向导勾选组件页或scoop install zedg-compat实现同样效果。

更新与卸载：保持精简的操作清单

💡 提示：卸载前如果执行过zedg-activate.sh，建议先--revert还原生态兼容状态。

常见问题 FAQ

问：macOS 提示"应用已损坏，无法打开"？执行sudo xattr -rd com.apple.quarantine /Applications/ZedG.app后重试即可。

问：终端里输入zedg提示 command not found？重新打开一次终端刷新 PATH；Scoop 用户确认scoop已正常安装，Homebrew 用户确认 cask 安装无报错。

问：装了 ZedG 后还能用官方 Zed 吗？能。默认安装（zedg）与官方 Zed 完全隔离；只有勾选了生态兼容（zedg-compat/--revert前的激活 / NSIS 覆盖选项）才会接管zed命令，且随时可还原。

想深度定制？本地构建与 AI 翻译流水线简介

对普通用户来说，直接下载预编译包即可。如果你是开发者，想从源码构建 Zed 中文版或新增语言，本项目提供完整的zedl10n工具链（源码位于 src/zedl10n/），流程为：

git clone https://gitcode.com/gh_mirrors/ze/zed-globalization cd zed-globalization pip install ".[all]" # 一键流水线：扫描 → 提取 → AI 翻译 → 替换源码 zedl10n pipeline --source-root zed --lang zh-CN --mode full

翻译术语统一由 config/glossary.yaml 维护，构建前补丁逻辑见 patch_agent_env.py。AI 翻译支持任意 OpenAI 兼容 API，通过AI_BASE_URL/AI_API_KEY/AI_MODEL环境变量配置。

🎉 至此，Zed 中文版的安装、更新、卸载和生态兼容配置就全部掌握了——打开 ZedG，即刻享受全中文界面 + 极速编辑体验吧！

• 开发工具
• 国际化
• AI 应用
• CLI