根据 “Building Zed for Windows” 官方文档内容，以下是清晰、分步的操作指南，帮助你顺利在 Windows 上从源码安装和构建 Zed 编辑器。
✅ 一、准备工作：确认系统要求
- 操作系统：Windows 10 或 11（建议最新版）
- 磁盘空间：至少 10 GB 空闲（Rust + 依赖体积较大）
- 用户权限：需本地管理员权限（安装工具链、SDK 等）
✅ 二、安装必要依赖（按顺序）
1. 安装 Rust 工具链（rustup）
打开 ：
https://rust-lang.org/tools/install/
- 安装完成后，重启终端，确保
cargo和rustc可用：rustc --version cargo --version
⚠️ 注意：不要手动设置
RUSTFLAGS环境变量，会破坏 Zed 的构建配置（见文档 Troubleshooting）。
2. 安装 MSVC 构建工具
选项 A（推荐）：安装 Visual Studio 2026 Community（免费）
- 下载地址：https://visualstudio.microsoft.com/downloads/
- 安装时勾选以下工作负载/组件：
- ✅ Desktop development with C++
- 在“安装详细信息”中确保包含：
MSVC v143 - VS 2022 C++ x64/x86 build toolsMSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libsCMake tools for Visual Studio-
Windows 11 SDK (10.0.26100.0)或 至少 Windows 10 SDK 2104 (10.0.20348.0)
选项 B（轻量）：仅安装 Build Tools for Visual Studio
- 下载地址：https://visualstudio.microsoft.com/visual-cpp-build-tools/
- 安装时选择：
- ✅ C++ build tools
- 勾选：
MSVC v143 ... build tools-
Windows 11 SDK（或 10.0.20348.0+） CMake tools
- ⚠️ 重要：不要直接在普通 CMD 中编译！ 必须通过 “Developer PowerShell for VS 2022” 启动终端（开始菜单中搜索），否则环境变量不生效。
3. 安装 CMake（若未通过 VS 安装）
- 官网下载：https://cmake.org/download/
- 推荐下载 Windows x64 Installer (.msi)，安装时勾选 “Add to PATH”
- 验证：
cmake --version
如果你通过 Visual Studio 安装了 CMake，需手动将路径（如
C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin）加入系统PATH。
4. 安装 Windows SDK（如未包含在 VS 中）
- 下载地址：https://developer.microsoft.com/windows/downloads/windows-sdk/
- 确保安装 Windows 10 SDK version 2104 (10.0.20348.0) 或更高
✅ 三、克隆 Zed 源码
D:\WORK\IDE>git clone https://gitee.com/mirrors/Zed-Editor.git
Cloning into 'Zed-Editor'...
remote: Enumerating objects: 479866, done.
remote: Counting objects: 100% (67274/67274), done.
remote: Compressing objects: 100% (20479/20479), done.
Receiving objects: 62% (297517/479866), 166.09 MiB | 9.39 MiB/s
cd zed
建议将项目放在短路径下（如
C:\src\zed），避免“Path too long”错误。
✅ 四、构建 Zed
在正确的终端中执行（关键！）
- 如果你安装的是 完整 Visual Studio：可在任意 PowerShell/CMD 中构建。
- 如果你只安装了 Build Tools：必须使用 “Developer PowerShell for VS ”。
建议在构建 Zed 时使用 “Developer PowerShell for VS ” 启动终端。这个终端会自动设置好所有 Visual Studio 相关的环境变量，包括 CMake 和 MSVC 编译器。
你可以在开始菜单中搜索 “Developer PowerShell for VS” 并启动它
执行构建命令
我的Zed目录：
cd D:\WORK\IDE\Zed-Editor
# 首次构建（debug 模式，较慢）
cargo run
# 或构建 release 版（推荐日常使用）
cargo run --release
首次构建可能耗时 10–30 分钟，取决于机器性能。
正在编译，需要从github下载依赖，整体时间很长
看到如下信息证明编译成功。
后续自动打开Zed
集成Qwen Code
- 安装 Qwen Code CLI：
一定要用管理员权限运行终端，右键点击「命令提示符」或「PowerShell」→ 选择「以管理员身份运行」；
PS C:\Windows\system32> npm install -g @qwen-code/qwen-code@latest --force
npm warn using --force Recommended protections disabled.
added 6 packages in 4s
PS C:\Windows\system32> qwen --version
0.5.2
- 在 Zed 中，点击右上角的 设置按钮，选择 “Add agent”，选择 “Add custom agent”，并添加以下配置：
"Qwen Code": {
"type": "custom",
"command": "qwen",
"args": ["--experimental-acp"],
"env": {}
}
集成Code buddy
Add More Agents
⚠️ 五、常见问题处理（按需）
1. “Path too long” 错误
- 启用 Windows 长路径支持（需管理员权限）：
# PowerShell（管理员） New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force - 并设置 Git 支持长路径：
git config --system core.longpaths true - 重启电脑生效。
2. RC.exe 找不到（Invalid RC path）
- 设置环境变量（临时）：
$env:ZED_RC_TOOLKIT_PATH = "C:\Program Files (x86)\Windows Kits\10\bin\10.0.20348.0\x64"请将
10.0.20348.0替换为你实际安装的 SDK 版本号。
3. Zed 启动失败（Vulkan 问题）
- 查看日志：
%LOCALAPPDATA%\Zed\logs\Zed.log - 如果出现
NoSupportedDeviceFound或GPU Crashed：- ✅ 更新显卡驱动（NVIDIA/AMD/Intel 官网）
- ❌ 卸载 Bandicam（已知冲突）
4. 不要使用 MSYS2 版本
- 文档明确说明：不支持
mingw-w64-zed，请勿从 MSYS2 安装。
✅ 六、后续使用建议
- 构建成功后，可将
target/release/zed.exe加入桌面快捷方式。 - 如需更新 Zed：
git pull后重新cargo run --release。 - 如遇构建失败：先运行
cargo clean再重试。
总结流程图
安装 Rust → 安装 VS/Build Tools + SDK + CMake → 克隆 Zed → 在 Developer Shell 中 cargo run --release
按此步骤操作，即可成功在 Windows 上从源码构建 Zed 编辑器。如遇特定错误，可结合日志和文档 Troubleshooting 部分进一步排查。
