为 Windows 构建 Zed

[!NOTE] 以下命令可以在任何 shell 中执行。

存储库

克隆 Zed 存储库。

依赖项

  • 安装 Rust。如果已安装，请确保它是最新版本

    rustup update

  • 安装 Rust wasm 工具链

    rustup target add wasm32-wasi

  • 安装 Visual Studio，并选择可选组件 MSVC v*** - VS YYYY C++ x64/x86 构建工具，然后根据你的系统安装 Windows 11 或 10 SDK

[!NOTE] v*** 是你的 VS 版本，YYYY 是你的 VS 发布年份。

后端依赖项

[!WARNING] 此部分仍在开发中。说明尚未完成。

如果你正在开发 Zed 的协作功能，则需要安装 Zed 的 collab 服务器的依赖项

或者，如果你已安装 Docker，你可以使用 Docker Compose 启用所有 collab 依赖项

docker compose up -d

从源代码构建

安装依赖项后，你可以使用 Cargo 构建 Zed。

进行调试构建

cargo run

进行发布构建

cargo run --release

运行测试

cargo test --workspace

从 msys2 安装

MSYS2 分发提供 Zed 作为包。要下载预构建的二进制文件，请运行

pacman -Syu
pacman -S mingw-w64-ucrt-x86_64-zed

然后你可以在 UCRT64 shell 中运行 zed。

[!NOTE] 请先在 https://github.com/msys2/MINGW-packages/issues 中报告任何问题。

故障排除

无法编译 zed

在报告问题之前，请确保使用 rustup update 拥有最新版本的 rustc。

Cargo 错误声称某个依赖项正在使用不稳定的功能

尝试 cargo clean 和 cargo build。

STATUS_ACCESS_VIOLATION

如果你正在使用“rust-lld.exe”链接器，可能会发生此错误。考虑尝试使用不同的链接器。

如果你正在使用全局配置，请考虑将 Zed 存储库移动到嵌套目录，并在父目录中添加一个带有自定义链接器配置的 .cargo/config.toml。

有关更多信息，请参阅此问题 #12041