从零构建 Wu:Rust 环境配置 + 本地编译 + 开发工作流完整指南

原创2026-11-13 12:19:101,947 阅读

从零构建 Wu:Rust 环境配置 + 本地编译 + 开发工作流完整指南

Wu 是一款用 Rust 编写的快速原生代码编辑器与 AI 智能体工作区,名字取自"无为"。这篇指南带你从零完成 Wu 的 Rust 环境配置、本地编译与日常开发工作流:安装指定版本的 Rust 工具链、配置构建依赖、用一条命令跑起编辑器,并建立 lint、测试的规范节奏,帮助新手和普通用户顺利上手源码开发。

先认识 Wu:它为什么值得从源码构建?

Wu 不用 Electron,也没有网页视图,界面由自研的 GPUI 框架直接渲染,打开即响应;内存占用比 VS Code 和 Zed 都低;并且内置了 Claude Code、Codex、OpenCode 等编程智能体。官方还发布了内存基准测试报告,可参考 docs/memory-benchmark.md。

Wu 编辑器界面截图:左侧项目文件树与 Rust 代码编辑区,底部终端显示本地编译运行日志

从源码构建有两个实际好处:

  • 🚀 体验 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 命令即可触发自动下载。

Wu 编辑器截图:打开 crates 工作区并查看 workspace 源码,终端展示 Wu 本地运行与内存诊断信息

安装平台构建依赖: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 的更多特性,逐步深入这个"无为"却强大的原生编辑器。

登录后查看全文
wu