第2章 Zed 编辑器安装指南：支持 macOS、Linux 与 Windows

下载 Zed

macOS

请通过下载页面获取最新稳定版。如需下载预览版，可在其发布页面找到。首次手动安装后，Zed 会定期检查是否有更新。

你也可以通过 Homebrew 安装 Zed 稳定版：

brew install --cask zed

安装 Zed 预览版的命令如下：

brew install --cask zed@preview

Windows

请通过下载页面获取最新稳定版。如需下载预览版，可在其发布页面找到。首次手动安装后，Zed 会定期检查是否有更新。

此外，你还可以通过 winget 安装 Zed：

winget install -e --id ZedIndustries.Zed

Linux

对于大多数 Linux 用户而言，通过安装脚本安装 Zed 是最简便的方式：

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

你还可以使用 ZED_VERSION 环境变量指定要安装的 Zed 版本：

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

# 安装特定版本
curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh

安装预览版（该版本比稳定版提前约一周获得更新）：

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

此脚本支持 x86_64 和 AArch64 架构，以及常见的 Linux 发行版，如 Ubuntu、Arch、Debian、RedHat、CentOS、Fedora 等。

如果通过此脚本安装了 Zed，随时可以运行 shell 命令 zed --uninstall 将其卸载。随后，shell 会提示你是要保留还是删除偏好设置。做出选择后，你将看到 Zed 成功卸载的提示信息。

如果这个脚本无法满足你的需求，或者你在运行 Zed 时遇到问题、卸载 Zed 时出现错误，请参阅我们的 Linux 专属文档。

系统要求

macOS

Zed 支持以下 macOS 版本：

标记为"部分支持"的版本（Big Sur 和 Catalina）不支持通过 Zed Collaboration 进行屏幕共享。该功能依赖 LiveKit SDK，而后者使用的 ScreenCaptureKit.framework 仅在 macOS 12（Monterey）及以上版本中可用。

Mac 硬件

Zed 支持满足上述 macOS 版本要求的 Intel（x86_64）和 Apple 芯片（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）处理器。

Zed 需要 Vulkan 1.3 驱动，并依赖以下桌面 portal：

• org.freedesktop.portal.FileChooser
• org.freedesktop.portal.OpenURI
• org.freedesktop.portal.Secret 或 org.freedesktop.Secrets

Windows

Zed 支持以下 Windows 版本： | 版本 | Zed 状态 | | ------------------------- | ------------------- | | Windows 11，22H2 或更高版本 | 支持 | | Windows 10，1903 或更高版本 | 支持 |

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

Windows 硬件要求

Zed 支持搭载 x64（Intel、AMD）或 Arm64（Qualcomm）处理器的设备，且需满足以下要求：

• 显卡：支持 DirectX 11 的 GPU（2012 年及以后的主流 PC 大多满足此条件）。
• 驱动：当前版本的 NVIDIA/AMD/Intel/Qualcomm 驱动（而非 Microsoft Basic Display Adapter）。

FreeBSD

目前尚未提供官方下载。可以从源码构建。

Web

暂不支持。请参阅我们的平台支持 Issue。

更新 Zed

Zed 设计为自动保持最新状态。您可以随时在设置中调整此行为。

自动更新

默认情况下，Zed 会在您下次重启应用时自动检查并安装更新。您始终运行的是最新版本，无需额外操作。

如果有可用更新，Zed 将在后台下载，并在重启时应用。

如何查看当前版本

要查看您正在使用的 Zed 版本：

打开命令面板（macOS 上为 Cmd+Shift+P，Linux/Windows 上为 Ctrl+Shift+P）。

输入并选择 {#action zed::About}。将显示包含版本信息的弹窗。

如何控制更新行为

如果希望关闭自动更新，请打开设置编辑器（Cmd ,）并在通用设置中找到 Auto Update。

卸载

本指南介绍如何在不同操作系统上卸载 Zed。

macOS

标准安装

如果您是从官网下载安装的 Zed：

1. 如果 Zed 正在运行，请先退出
2. 打开 Finder，前往“应用程序”文件夹
3. 将 Zed 拖到废纸篓（或右键选择“移到废纸篓”）
4. 清空废纸篓

Homebrew 安装

如果您使用 Homebrew 安装 Zed，请执行以下命令：

brew uninstall --cask zed

或者对于预览版：

brew uninstall --cask zed@preview

删除用户数据（可选）

若要彻底清除 Zed 的所有配置文件和数据：

1. 打开 Finder
2. 按下 Cmd + Shift + G 打开“前往文件夹”
3. 若以下目录存在，请删除： - ~/Library/Application Support/Zed - ~/Library/Saved Application State/dev.zed.Zed.savedState - ~/Library/Logs/Zed - ~/Library/Caches/dev.zed.Zed - ~/Library/Caches/Zed - ~/.config/zed - ~/.local/state/Zed

Linux

标准卸载

如果 Zed 是通过默认安装脚本安装的，请运行：

zed --uninstall

系统会询问是否保留或删除偏好设置。做出选择后，您将看到 Zed 已成功卸载的消息。

如果在 PATH 中找不到 zed 命令，请尝试：

$HOME/.local/bin/zed --uninstall

或者：

$HOME/.local/zed.app/bin/zed --uninstall

包管理器

如果您使用包管理器（如 Flatpak、Snap 或发行版特定的包管理器）安装了 Zed，请参阅相应包管理器的文档以获取卸载说明。

手动移除

如果卸载命令失败或 Zed 安装在自定义位置，您可以手动移除以下内容：

• 安装目录：~/.local/zed.app（或您的自定义安装路径）
• 二进制符号链接：~/.local/bin/zed
• 配置和数据：~/.config/zed

Windows

标准安装

1. 如果 Zed 正在运行，请退出它
2. 打开设置（Windows 键 + I）
3. 进入“应用” > “已安装的应用”（或在 Windows 10 中为“应用和功能”）
4. 搜索“Zed”
5. 点击 Zed 旁边的三点菜单并选择“卸载”
6. 按照提示完成卸载

或者，您可以：

1. 打开开始菜单
2. 右键单击 Zed
3. 选择“卸载”

删除用户数据（可选）

若要彻底清除 Zed 的所有配置文件和数据：

1. 按下 Windows 键 + R 打开运行
2. 输入 %APPDATA%，按回车
3. 如果存在 Zed 文件夹，将其删除
4. 再次按 Windows 键 + R，输入 %LOCALAPPDATA%，按回车
5. 如果存在 Zed 文件夹，将其删除

故障排除

如果卸载时遇到问题：

• macOS/Windows：卸载前请确保 Zed 已完全退出。可在活动监视器（macOS）或任务管理器（Windows）中检查是否有 Zed 进程仍在运行。
• Linux：如果卸载脚本执行失败，请查看错误信息，也可以手动删除上述目录。
• 所有平台：如果不想卸载软件、只想恢复初始配置，可以直接删除配置目录。

如需更多帮助，请参阅我们的 Linux 专属文档，或访问 Zed 社区。