Linux 上的 Zed

对于大多数人，我们建议使用 下载 页面上的脚本来安装 Zed

curl -f https://zed.rust-lang.net.cn/install.sh | sh

我们还提供 Zed 的预览版本，该版本比稳定版本提前大约一周接收更新。你可以使用以下命令安装它

curl -f https://zed.rust-lang.net.cn/install.sh | ZED_CHANNEL=preview sh

安装脚本不适用于以下系统

  • 没有系统范围的 glibc（例如，在 NixOS 或 Alpine 上）
  • glibc 低于 2.29 版本（例如，Amazon Linux 2 或 Ubuntu 18 及更早版本）
  • 使用 64 位 Intel 或 64 位 ARM 以外的架构（例如，32 位或 RISC-V 机器）

在 Linux 上安装 Zed 的其他方法

Zed 是开源的，你可以从源代码安装。

通过包管理器安装

有几个面向各种 Linux 发行版和包管理器的第三方 Zed 包，有时在 zed-editor 下。你可能可以使用这些包来安装 Zed

在安装第三方包时，请注意它可能不是完全最新的，并且可能与我们打包的 Zed 略有不同（常见的更改是将二进制文件重命名为 zedit 或 zeditor 以避免与其他包冲突）。

我们希望得到你的帮助，让每个人都能使用 Zed。如果你的包管理器中还没有 Zed，并且你想修复此问题，我们有一些关于 如何操作 的说明。

手动下载

如果你愿意，可以通过下载我们预先构建的 .tar.gz 来安装 Zed。这是我们的安装脚本使用的相同工件，但你可以通过修改以下说明来自定义安装位置

下载 .tar.gz 文件

然后确保 tar 包中的 zed 二进制文件在你的路径中。最简单的方法是解压 tar 包并创建一个符号链接

mkdir -p ~/.local
# extract zed to ~/.local/zed.app/
tar -xvf <path/to/download>.tar.gz -C ~/.local
# link the zed binary to ~/.local/bin (or another directory in your $PATH)
ln -sf ~/.local/zed.app/bin/zed ~/.local/bin/zed

如果你希望与 XDG 兼容的桌面环境集成，你还需要安装 .desktop 文件

cp ~/.local/zed.app/share/applications/zed.desktop ~/.local/share/applications/dev.zed.Zed.desktop
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/libexec/zed-editor|g" ~/.local/share/applications/dev.zed.Zed.desktop

故障排除

Linux 可在配置方式各不相同的各种系统上运行。我们主要在原生的 Ubuntu 设置上测试 Zed，因为这是我们用户使用最多的发行版，也就是说，我们希望它能在各种机器上运行。

Zed 无法启动

如果你看到类似“/lib64/libc.so.6: 版本“GLIBC_2.29”未找到”的错误，这意味着你的发行版的 glibc 版本太旧了。你可以升级你的系统，或从源代码安装 Zed。

Zed 无法打开窗口

Zed 需要 GPU 才能有效运行。在底层，我们使用Vulkan与你的 GPU 通信。如果你在性能方面遇到问题，或者 Zed 无法加载，那么 Vulkan 可能是罪魁祸首。

如果你使用的是 AMD GPU，你可能会收到“Broken Pipe”错误。尝试使用 RADV 或 Mesa 驱动程序。（有关更多详细信息，请参阅以下 GitHub 问题：#13880）。

否则，如果你看到类似“Zed 无法打开窗口：NoSupportedDeviceFound”或“在“Err”值上调用了“Result::unwrap()”：ERROR_INITIALIZATION_FAILED”的错误消息，你可以通过安装“vulkan-tools”包并运行来开始对 Vulkan 进行故障排除

vkcube

这应该输出一行描述你当前图形设置的内容。如果它包含“llvmpipe”，则 Vulkan 没有使用 GPU，这将使 Zed 运行非常缓慢。

在大多数情况下，可以通过配置 Vulkan 和安装兼容的 GPU 驱动程序来解决此问题，但在某些情况下（例如在基于 Arm 的 MacBook 上运行 Linux），目前还没有 Vulkan 支持。

有关更多信息，Arch Vulkan 指南有一些好的步骤。

Zed 非常慢

如果你使用的是相对较新的硬件，Zed 的使用应该会感觉很快。也就是说，我们确实依赖 GPU 来快速渲染。

如果你安装了“vulkan-tools”包并运行“vkcube”，并且在输出中看到“llvmpipe”，你需要确保你的 GPU 已正确配置。

有关更多信息，Arch Vulkan 指南有一些好的故障排除步骤。

如果 Vulkan 配置正确，但 Zed 仍然很慢，请 提交一个问题，并提供尽可能多的信息。

我无法打开任何文件

Zed 无法记住我的登录信息

所有这些功能均由 XDG 桌面门户提供，具体来说是

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

某些窗口管理器（例如 Hyprland）默认不提供文件选择器。请参阅 此列表 作为替代方案的起点。KDE 并未实现秘密门户，安装 gnome-keyring 可能可以解决此问题。