Zed 在 Linux 上

對於大多數人，我們建議使用 下載 頁面上的腳本來安裝 Zed

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

我們還提供 Zed 的預覽版本，它會比穩定版提前大約一周收到更新。您可以使用以下指令安裝它

curl -f https://zed.dev.org.tw/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 檔案

然後確保 tarball 中的 zed 二進制文件位於您的路徑中。最簡單的方法是解壓縮 tarball 並建立符號連結

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: version 'GLIBC_2.29' not found」的錯誤訊息，則表示您的發行版的 glibc 版本太舊。您可以升級您的系統，或 從原始碼安裝 Zed。

Zed 無法開啟視窗

Zed 需要 GPU 才能有效運作。在底層，我們使用 Vulkan 與您的 GPU 進行通訊。如果您遇到效能問題，或 Zed 無法載入，則可能是 Vulkan 造成的。

如果您使用的是 AMD GPU，則可能會收到「Broken Pipe」錯誤。請嘗試使用 RADV 或 Mesa 驅動程式。（如需詳細資訊，請參閱以下 GitHub 問題：#13880）。

否則，如果您看到以下錯誤訊息：「Zed failed to open a window: NoSupportedDeviceFound」或「called Result::unwrap() on an Err value: 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 未實作 secret 入口網站，安裝 gnome-keyring 可以解決此問題。