从零构建 Wu:Rust 环境配置 + 本地编译 + 开发工作流完整指南
从零构建 Wu:Rust 环境配置 + 本地编译 + 开发工作流完整指南
Wu 是一款用 Rust 编写的快速原生代码编辑器与 AI 智能体工作区,名字取自"无为"。这篇指南带你从零完成 Wu 的 Rust 环境配置、本地编译与日常开发工作流:安装指定版本的 Rust 工具链、配置构建依赖、用一条命令跑起编辑器,并建立 lint、测试的规范节奏,帮助新手和普通用户顺利上手源码开发。
先认识 Wu:它为什么值得从源码构建?
Wu 不用 Electron,也没有网页视图,界面由自研的 GPUI 框架直接渲染,打开即响应;内存占用比 VS Code 和 Zed 都低;并且内置了 Claude Code、Codex、OpenCode 等编程智能体。官方还发布了内存基准测试报告,可参考 docs/memory-benchmark.md。
从源码构建有两个实际好处:
- 🚀 体验 dev 版本的全部功能,包括 Inspector 调试等开发特性;
- 🛠️ 建立完整的 Rust 开发工作流,为后续贡献代码打基础。
克隆 Wu 仓库:准备工作区
第一步是把源码拿到本地。打开终端,执行:
git clone https://gitcode.com/gh_mirrors/wu3/wu
cd wu
建议直接克隆到磁盘空间充足的位置——Rust 工作区编译产物较大,target/ 目录占用几个 GB 属正常现象。仓库根目录的 Cargo.toml 声明了一个包含 170+ 个 crate 的工作区,主程序是 crates/wu,其 default-members 已指向它,因此大多数 cargo 命令无需指定包名。
一键安装 Rust 工具链:版本自动锁定
Wu 通过 rust-toolchain.toml 锁定了精确的 Rust 版本与附加组件:
[toolchain]
channel = "1.97.1"
profile = "minimal"
components = [ "rustfmt", "clippy", "rust-analyzer", "rust-src" ]
targets = [
"wasm32-wasip2", # 扩展
"wasm32-unknown-unknown", # 网页端 gpui
"x86_64-unknown-linux-musl", # 远程服务器
]
只要装好了 rustup,进入仓库目录后执行任何 cargo 命令,它会读取该文件自动下载 1.97.1 版本及全部 targets,无需手动 rustup install:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
💡 如果你已经安装过 rustup,这一步可以跳过,直接执行 cargo 命令即可触发自动下载。
安装平台构建依赖:Linux 一条命令搞定
Wu 依赖 C++ 编译器、Vulkan/Wayland 图形栈、SQLite 等系统库。Linux 用户直接运行仓库自带的脚本即可,它会自动识别发行版(apt / dnf / zypper / pacman / xbps / emerge)并安装对应依赖,未装 rustup 时还会顺带装好:
./script/linux
脚本全文见 script/linux。macOS 和 Windows 用户建议查阅 docs/INSTALL.md 中的说明;官方构建方式与 Zed 一致,主要差别在平台图形库(macOS 使用 Metal,Linux 使用 Wayland/X11,见 crates/wu/Cargo.toml)。
首次本地编译 Wu:从源码启动编辑器
依赖就绪后,最快捷的方式是边编译边运行:
cargo run
首次编译会处理上百个 crate,耗时较长(视硬件从十几分钟到半小时不等)属正常现象。仓库在 Cargo.toml 中已为 dev profile 做了编译加速优化:incremental = true、debug = 0,并给 tree-sitter、wasmtime 等重型依赖单独开启 opt-level = 3,所以增量重编译会明显快很多。
需要发布版本产物时:
# 标准 release(thin LTO,体积更小、性能更高)
cargo build --release
# release-fast:编译更快,适合本地调试
cargo build --profile release-fast
日常开发工作流:lint、测试与代码规范
跑起来只是开始。Wu 对代码质量有明确要求,建议养成以下习惯:
- 质量检查用专用脚本:运行
./script/clippy(见 script/clippy)而非cargo clippy。它会对整个工作区执行--release --all-targets --all-features --deny warnings,并顺带跑cargo-shear、typos等附加检查。 - 测试:
cargo test覆盖各 crate 的单元测试与集成测试。 - 编码规范:仓库根目录的 AGENTS.md 是核心规范,要点包括:优先正确性与可读性、避免
unwrap()改用?传播错误、不静默丢弃错误、新模块用src/some_module.rs而非mod.rs。 - 构建计时:script/cargo 是 cargo 的包装器,执行
./script/cargo --init后可自动记录编译耗时,方便定位慢在哪。 - 入口代码:主程序入口是 crates/wu/src/main.rs,负责 CLI 参数解析、工作区初始化与窗口创建,是理解整体架构的好起点。
常用命令速查表
| 场景 | 命令 |
|---|---|
| 编译并运行编辑器 | cargo run |
| 快速类型检查(不产出二进制) | cargo check |
| 运行全部测试 | cargo test |
| 全工作区 lint(项目标准) | ./script/clippy |
| Release 构建 | cargo build --release |
| 快速 Release 构建 | cargo build --profile release-fast |
| 打包 Linux 发布版 | ./script/bundle-linux |
| 打包 macOS 发布版 | ./script/bundle-mac |
写在最后
至此,你已完成 Wu 从零到一的全流程:Rust 1.97.1 工具链由 rust-toolchain.toml 自动锁定,平台依赖用 script/linux 一键安装,cargo run 即可从源码启动编辑器,再用 ./script/clippy 与 cargo test 保持代码质量。接下来可以打开 crates/wu/src/main.rs 从入口开始阅读架构,或参考 README.zh-CN.md 了解 Wu 的更多特性,逐步深入这个"无为"却强大的原生编辑器。

