zed

1- 在 Windows 上构建 Zed

以下命令可以在任何 shell 中执行。

1.1- 代码库

克隆 Zed 代码仓库。

1.2- 依赖项

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

    rustup update

  • 安装 Rust wasm 工具链：

    rustup target add wasm32-wasip1

  • 安装 Visual Studio 并选择安装可选组件 MSVC v* - VS YYYY C++ x64/x86 build tools （v* 是你的 VS 版本，YYYY 是你的 VS 发布年份）

  • 根据你的系统安装 Windows 11 或 10 SDK，但请确保你的机器上至少安装了 Windows 10 SDK 版本 2104 (10.0.20348.0)。你可以从 Windows SDK Archive 下载它。

1.3- 安装 CMake

1.3.1- 使用 winget 安装 CMake

winget install --id=Kitware.CMake -e

1.3.2- 验证安装

安装完成后，可以通过以下命令验证 CMake 是否安装成功：

cmake --version

如果安装成功，你将看到类似如下的输出，显示 CMake 的版本号：

cmake version x.y.z

1.3.3- 配置环境变量（如果需要）

在某些情况下，CMake 的安装路径可能没有自动添加到系统的 PATH 环境变量中。你可以手动添加：

  1. 打开“系统属性”对话框（可以通过右键点击“此电脑”图标，选择“属性”，然后点击“高级系统设置”）。
  2. 点击“环境变量”按钮。
  3. 在“系统变量”部分，找到并选择“Path”变量，然后点击“编辑”。
  4. 点击“新建”，然后添加 CMake 的安装路径（例如 C:\Program Files\CMake\bin）。
  5. 点击“确定”保存更改。

1.3.4- 安装 Visual Studio Code 和 CMake 插件（可选）

为了更好地进行 CMake 项目开发，建议安装 Visual Studio Code 以及相关插件。

1.3.4.1- 安装 CMake 插件

在 Visual Studio Code 中，打开扩展（Extensions）面板，搜索并安装 CMake 和 CMake Tools 插件。这将为你提供 CMake 项目的语法高亮、配置和构建等功能。

通过以上步骤，你已经成功使用 winget 安装并配置了 CMake 开发环境。现在，你可以开始使用 CMake 进行项目构建和管理了。祝你开发顺利！

1.4- 后端依赖项

此部分仍在开发中。说明尚未完成。

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

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

docker compose up -d

2- 从源码构建

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

要进行调试构建：

cargo run

要进行发布构建：

cargo run --release

要运行测试：

cargo test --workspace

3- 从 msys2 安装

MSYS2 发行版提供 Zed 作为软件包 mingw-w64-zed。要下载预构建的二进制文件，请运行

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

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

你可以查看 构建脚本 以获取更多详细信息。

请先在 msys2/MINGW-packages/issues 中报告任何问题。

4- 故障排除

4.1- 无法编译 Zed

在报告问题之前，请确保你使用 rustup update 获取了最新的 rustc 版本。

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

尝试 cargo clean 和 cargo build。

4.3- STATUS_ACCESS_VIOLATION

如果你使用的是 “rust-lld.exe” 链接器，则可能会发生此错误。考虑尝试其他链接器。

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

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