Zed 全平台安装权威指南：macOS、Linux、Windows 的安装方式、系统要求与卸载详解

导读

Zed 是一款由 Atom 与 Tree-sitter 原作者打造的高性能、支持多人实时协作的代码编辑器。本文以仓库内官方安装文档 docs/src/installation.md 为主体，系统讲解如何在 macOS、Linux、Windows 上通过官方下载、Homebrew、winget 与官方安装脚本等途径安装 Zed（含 preview 预览渠道），并完整梳理各平台的系统要求与硬件支持矩阵。读完本文，你将能够根据自身操作系统与硬件条件选择最合适的安装方案，完成安装、卸载与常见故障的排查。

Zed 的发行遵循 stable（稳定）、preview（预览）、nightly（每夜）、dev（开发） 四类渠道，对应源码中的 ReleaseChannel 枚举（见 crates/release_channel/src/lib.rs）。其中 stable 为默认渠道，preview 比 stable 提前约一周接收更新。理解渠道概念，是理解下文各类安装命令的前提。

下载 Zed

无论哪个平台，你都可以从 Zed 官网的下载页获取最新的稳定构建；如果你希望尝鲜 preview 版本，则需要到对应的 preview releases 页面下载。首次手动安装完成后，Zed 会定期自动检查更新——该行为在源码中由自动更新模块驱动：crates/auto_update/src/auto_update.rs 中的 AutoUpdater 会根据发布渠道的 poll_for_updates() 返回值（crates/release_channel/src/lib.rs）与用户 auto_update 设置决定是否启动轮询，你可以在 Zed 设置中通过 auto_update 选项关闭这一行为。

macOS 安装

macOS 用户最便捷的方式是使用 Homebrew 安装 stable 版：

brew install --cask zed

安装 preview 预览版：

brew install --cask zed@preview

除 Homebrew 外，也可直接下载 dmg 安装包（.dmg）手动安装到 /Applications。仓库内的官方安装脚本 script/install.sh 展示了 macOS 手动安装的内部流程：脚本下载 Zed-<arch>.dmg，通过 hdiutil attach 挂载磁盘镜像，将 .app 复制到 /Applications，最后在 ~/.local/bin 下为 zed 命令建立指向 /Applications/Zed.app/Contents/MacOS/cli 的符号链接（见 script/install.sh）。

Windows 安装

Windows 用户可以：

• 从下载页获取最新 stable 构建；preview 版本前往 preview releases 页面获取；
• 使用 winget 包管理器一键安装：

winget install -e --id ZedIndustries.Zed

winget 包 ID 对应发布渠道的 app_id dev.zed.Zed（stable）。首次手动安装后，Zed 同样会自动检查更新。

Linux 安装

对绝大多数 Linux 用户而言，最简单的方式是使用官方安装脚本：

curl -f https://zed.dev/install.sh | sh

安装脚本源码即仓库中的 script/install.sh，理解它能帮你弄清脚本到底做了什么：

1. 平台识别与架构归一化：脚本通过 uname -s / uname -m 判断平台与架构，将 Darwin 映射为 macos、Linux 映射为 linux，并将 arm64/aarch64 归一到 aarch64、x86 系列归一到 x86_64（script/install.sh）。因此它同时支持 macOS 与 Linux，以及 x86_64 与 AArch64 两种架构。
2. 下载安装包：从发布服务下载对应渠道与架构的 .tar.gz（Linux）或 .dmg（macOS）压缩包。
3. 解压到用户目录：Linux 下解压至 ~/.local/，可执行文件位于 ~/.local/zed.app/bin/zed（非 stable 渠道的目录名带渠道后缀，如 ~/.local/zed-preview.app）。
4. 建立符号链接：将 ~/.local/bin/zed 链接到安装目录内的 zed 二进制（script/install.sh），保证 zed 命令在 PATH 中可用；若 ~/.local/bin 不在 PATH，脚本会依据你的 shell 类型输出对应的 PATH 追加命令（zsh 写 ~/.zshrc，fish 用 fish_add_path，其余写 ~/.bashrc）。
5. 安装桌面入口：复制对应渠道的 .desktop 文件到 ~/.local/share/applications，并将 Icon 与 Exec 字段改写为绝对路径，以接入 XDG 兼容的桌面环境（script/install.sh）。
6. 依赖预检：脚本会用 ldd 检查可执行文件是否有缺失的动态库（如 libGL 相关库），若有会打印警告提示你先安装缺失库。

指定版本安装（ZED_VERSION 环境变量）

脚本支持通过 ZED_VERSION 环境变量指定要安装的 Zed 版本：

# 安装最新的稳定版本（默认行为）
curl -f https://zed.dev/install.sh | sh

# 安装指定版本（例如 0.216.0）
curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh

安装预览版（ZED_CHANNEL 环境变量）

preview 构建会比 stable 提前约一周收到更新，安装命令为：

curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh

脚本内部以 ZED_CHANNEL（默认 stable，可选 preview/nightly/dev）决定下载渠道，并据此确定应用目录后缀与 app_id（如 preview 对应 dev.zed.Zed-Preview，见 script/install.sh）。

官方脚本支持的发行版

该脚本支持 x86_64 与 AArch64 两种架构，并覆盖 Ubuntu、Arch、Debian、RedHat、CentOS、Fedora 等主流发行版。但脚本产出的二进制并非所有系统都能直接运行，其适用前提为：

• 拥有 Vulkan 兼容 GPU（例如在 M 系列 MacBook 上跑 Linux 虚拟机）；
• 系统级 glibc 满足版本要求：
  • x86_64（Intel/AMD）：glibc >= 2.31（对应 Ubuntu 20 及更新版本）；
  • aarch64（ARM）：glibc >= 2.35（对应 Ubuntu 22 及更新版本）。

NixOS 默认没有系统级 glibc，若要在 NixOS 上使用官方构建，通常需要安装 glibc 兼容层（如 nix-ld）。而以下场景则必须从源码自行构建：

• 非 64 位 Intel 或 64 位 ARM 的架构（如 32 位或 RISC-V 机器）；
• RedHat Enterprise Linux 8.x、Rocky Linux 8、AlmaLinux 8、Amazon Linux 2（所有架构）；
• RedHat Enterprise Linux 9.x、Rocky Linux 9.3、Amazon Linux 2023 的 aarch64 架构（x86_64 可用）。

这些系统约束的细节可进一步参阅 Linux 专项文档。

脚本安装后的卸载

通过安装脚本安装的 Zed，随时可以用 zed --uninstall 命令卸载：

zed --uninstall

执行后，终端会询问你是保留还是删除 Zed 的偏好设置（preferences）。做出选择后，会看到 Zed 成功卸载的提示。--uninstall 的实际执行逻辑位于 crates/cli/src/main.rs：CLI 解析到 --uninstall 参数后，将内嵌的 script/uninstall.sh 解出并执行（crates/cli/src/main.rs）。

卸载脚本会依据 ZED_CHANNEL 判断当前卸载的是哪个渠道变体：移除 ~/.local/zed*.app 应用目录、~/.local/bin/zed 符号链接与对应渠道的 .desktop 文件，并清理该渠道的数据库目录与 socket 文件；当系统上不再残留任何 Zed 安装时，才提示是否删除 ~/.config/zed 偏好目录（script/uninstall.sh）。

注意，zed --uninstall 卸载的是符号链接指向的那个 Zed 变体。如果你并行安装了多个版本（例如同时装了 Stable 与 Preview），应改用安装目录内二进制的绝对路径来卸载，例如：

$HOME/.local/bin/zed --uninstall
# 或安装目录下的绝对路径
$HOME/.local/zed.app/bin/zed --uninstall
$HOME/.local/zed-preview.app/bin/zed --uninstall

若 zed 命令不在 PATH 中，第一种方式可能因符号链接缺失而失败，但第二种只要 Zed 安装在默认位置就总是有效。若是通过包管理器（Homebrew、winget 等）安装的 Zed，请按对应包管理器的文档执行卸载。

如果脚本不足以覆盖你的场景、运行 Zed 遇到问题，或卸载报错，请查阅仓库内的 Linux 专项文档（含发行版打包说明与故障排查）。

Linux 手动安装（tar.gz 方式）

如果你不想使用安装脚本，也可以手动下载官方预构建的 .tar.gz 包（这正是安装脚本内部使用的同一构件），从而自定义安装位置。步骤为：

1. 按架构下载 zed-linux-x86_64.tar.gz 或 zed-linux-aarch64.tar.gz（同样提供 preview 版本）；
2. 解压并把 zed 二进制放入 PATH：

mkdir -p ~/.local
# 将 zed 解压到 ~/.local/zed.app/
tar -xvf <path/to/download>.tar.gz -C ~/.local
# 将 zed 二进制链接到 ~/.local/bin（或 PATH 中的其他目录）
ln -sf ~/.local/zed.app/bin/zed ~/.local/bin/zed

3. 若需要与 XDG 兼容的桌面环境集成，还需安装 .desktop 文件：

install -D ~/.local/zed.app/share/applications/dev.zed.Zed.desktop -t ~/.local/share/applications
sed -i "s|Icon=zed|Icon=$HOME/.local/zed.app/share/icons/hicolor/512x512/apps/zed.png|g" ~/.local/share/applications/dev.zed.Zed.desktop
sed -i "s|Exec=zed|Exec=$HOME/.local/zed.app/bin/zed|g" ~/.local/share/applications/dev.zed.Zed.desktop

各 Linux 发行版还存在由社区维护的第三方包（部分更名为 zed-editor，个别发行版将二进制重命名为 zedit/zeditor 以避免冲突），例如 Arch（zed、AUR 中的 zed-git/zed-preview）、Fedora/Ultramarine、Nix（zed-editor）、Flathub（dev.zed.Zed）等。社区包可能并非完全同步最新版本，安装第三方包时需自行留意其维护情况。若你的发行版尚无 Zed 包且愿意帮忙打包，可参考 Linux 构建与打包说明 中关于打包 Zed 的备注。

系统要求

macOS

Zed 支持的 macOS 版本如下：

版本	代号	Apple 支持状态	Zed 支持状态
macOS 26.x	Tahoe	支持	支持
macOS 15.x	Sequoia	支持	支持
macOS 14.x	Sonoma	支持	支持
macOS 13.x	Ventura	支持	支持
macOS 12.x	Monterey	EOL 2024-09-16	支持
macOS 11.x	Big Sur	EOL 2023-09-26	部分支持
macOS 10.15.x	Catalina	EOL 2022-09-12	部分支持

标注为“部分支持”（Partially Supported）的 macOS 版本（Big Sur 与 Catalina）不支持通过 Zed 协作功能进行屏幕共享。因为该功能基于 LiveKit SDK，后者依赖仅在 macOS 12（Monterey）及更高版本中才提供的 ScreenCaptureKit.framework 框架。

Mac 硬件支持：Zed 支持满足上述 macOS 版本要求、采用 Intel（x86_64）或 Apple Silicon（aarch64）处理器的设备，具体包括：

• MacBook Pro（2015 年初及更新）
• MacBook Air（2015 年初及更新）
• MacBook（2016 年初及更新）
• Mac Mini（2014 年底及更新）
• Mac Pro（2013 年底及更新）
• iMac（2015 年底及更新）
• iMac Pro（全型号）
• Mac Studio（全型号）

Linux

Zed 支持 64 位 Intel/AMD（x86_64）与 64 位 Arm（aarch64）处理器，并且：

• 需要 Vulkan 1.3 图形驱动（Zed 底层使用 Vulkan 与 GPU 通信）；
• 需要以下 XDG 桌面门户（desktop portals）提供系统集成能力：
  • org.freedesktop.portal.FileChooser（文件选择对话框）
  • org.freedesktop.portal.OpenURI（打开外部链接）
  • org.freedesktop.portal.Secret 或 org.freedesktop.Secrets（密钥安全存储，用于保存登录态与 API Key）

其中文件对话框与打开链接由前两个 portal 提供，而“记不住 API Key / 记不住登录”的问题通常与第三个（密钥存储 portal）缺失有关，此类场景需要 gnome-keyring、KWallet、keepassxc 等提供系统钥匙串的软件。此外 Zed 依赖 inotify 监听文件系统变化，若 fs.inotify.max_user_watches 过低或文件描述符耗尽，Zed 将无法可靠工作，可通过 sysctl 调整相关内核限制（详见 Linux 专项文档）。

Linux 图形相关的常见故障（如启动失败提示 Zed failed to open a window: NoSupportedDeviceFound，表明 Vulkan 找不到可用 GPU）可在 Linux 专项文档中找到系统化的排查方法：使用 vkcube 验证 Vulkan 可用性、通过 ZED_DEVICE_ID=0x.... zed 或 Mesa 的 MESA_VK_DEVICE_SELECT 强制指定 GPU、通过 zed --system-specs 收集系统信息以便提交问题等。

Windows

Zed 支持的 Windows 版本如下：

版本	Zed 支持状态
Windows 11，版本 22H2 及更新	支持
Windows 10，版本 1903 及更新	支持

运行 Zed 需要 64 位操作系统。

Windows 硬件支持：Zed 支持采用 x64（Intel、AMD）或 Arm64（Qualcomm）处理器的设备，具体要求为：

• 显卡：支持 DirectX 11 的 GPU（2012 年后的绝大多数 PC 均可）；
• 驱动：需使用最新的 NVIDIA/AMD/Intel/Qualcomm 官方驱动（而非 Microsoft 基本显示适配器）。

FreeBSD 与 Web 平台状态

• FreeBSD：目前尚无可下载的官方发行包，需要从源码自行构建，请参考仓库内的 FreeBSD 构建指南。该指南提供了依赖安装脚本 script/freebsd、调试构建（cargo run）、运行测试（cargo test --workspace）以及通过 cli crate 运行开发版（cargo run -p cli）的方法。需要留意的是，由于上游支持缺失，webrtc-sys 在 FreeBSD 上暂时无法编译，基于 WebRTC 的协作功能（语音通话与屏幕共享）在 FreeBSD 构建中暂时不可用。
• Web：Zed 目前不支持 Web 平台，请关注仓库内的 Platform Support issue 以跟踪进展。

安装后的验证与进一步阅读

安装完成后，可在终端输入 zed 启动编辑器。若需要验证 GPU 渲染是否正常，Linux 用户可在 Zed 日志（~/.local/share/zed/logs/Zed.log）中检索 Using GPU: ... 一行来确认 Zed 实际使用的显卡。

关于更新、卸载与各平台的专项说明，可继续阅读仓库内对应文档：

• 各平台专项安装细节：Linux、macOS、Windows
• 更新机制：在 Zed 设置中通过 auto_update 开关控制自动检查，参见 自动更新模块 与更新文档 docs/src/update.md
• 卸载说明：docs/src/uninstall.md
• Linux/FreeBSD 从源码构建：Linux、FreeBSD
• 安装脚本与卸载脚本的源码实现：script/install.sh、script/uninstall.sh

（仓库内安装类源码与脚本路径：安装 CLI、卸载 CLI 参数解析）