5分钟上手VectorCraft:Rust矢量编辑器安装、构建与第一个SVG项目实战
【免费下载链接】vectorcraftAn open-source, clean-room reimplementation of Adobe Illustrator, built in pure Rust.项目地址: https://gitcode.com/gh_mirrors/ve/vectorcraft
VectorCraft是一个开源的矢量图形编辑器,用纯 Rust 从零实现,目标是完整复刻 Adobe Illustrator 的工作流:钢笔工具、Pathfinder 路径查找器、渐变网格、实时混合、外观面板一应俱全。它免费、跨平台(macOS、Windows、Linux、FreeBSD,甚至能在浏览器里跑),并且原生支持 SVG 导入导出——非常适合想用Rust 矢量编辑器快速完成SVG 项目的新手。
1. 认识 VectorCraft:免费的 Illustrator 替代方案
在动手之前,先花 30 秒了解它为什么值得上手:
- 熟悉的手感:Illustrator 式的布局、菜单、面板与快捷键,用过 AI 的可以直接上手;
- 快:多线程 SIMD 渲染,2 万个图形约 27ms 出图,界面保持 120fps;
- 开放的文件格式:原生
.vectorcraft格式(JSON,可 diff)、一等公民 SVG、PDF 导入导出,还有 PNG/JPEG/WebP 导出; - AI 原生:内置 MCP 服务器,可以让 AI Agent 像人一样画图、改图、导出。
2. 安装 VectorCraft:环境准备与克隆仓库
2.1 前置要求:安装 Rust 工具链
VectorCraft 使用 Rust 2024 edition,需要较新的工具链(工作区要求 Rust 1.95+):
# 官方安装脚本 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh2.2 克隆仓库
git clone https://gitcode.com/gh_mirrors/ve/vectorcraft cd vectorcraft仓库结构一目了然:crates/是功能模块(几何、颜色、文档、渲染、SVG、PDF、引擎……),apps/是三个可执行程序(桌面版、CLI、Web 版),示例文件放在 examples/。
3. 构建 VectorCraft 桌面应用(cargo 完整步骤)
3.1 一条命令启动桌面应用
cargo run --release -p vectorcraft首次编译时间稍长(依赖较多),之后增量编译会快很多。窗口打开后就是熟悉的 Illustrator 式界面:左侧工具栏、右侧属性面板、底部状态栏。
想直接打开示例文件体验:
cargo run --release -p vectorcraft -- examples/dusk-poster.vectorcraft3.2 打包正式安装包(可选)
- macOS:
cargo xtask bundle生成dist/VectorCraft.app; - Web 版(浏览器里跑同一个应用):
brew install trunk # 或 cargo install trunk --locked rustup target add wasm32-unknown-unknown cd apps/vectorcraft-web trunk serve --release # 开发服务器 http://127.0.0.1:8766Web 版通过 WebGPU(或回退 WebGL2)渲染,详情见 docs/development.md。
4. 第一个 SVG 项目实战:打开、编辑、导出
4.1 打开示例 SVG 文件
VectorCraft 可以直接打开 SVG。仓库自带一份现成的示例 examples/dusk-poster.svg(黄昏海报),双击或在菜单文件 › 打开中选中它:
4.2 用钢笔工具与直接选择工具编辑路径
- 按V切换到选择工具,点选图形查看图层与外观;
- 按A切换到直接选择工具,你会看到真实的贝塞尔锚点与手柄,拖动手柄即可改变曲线;
- 用Pathfinder 面板做并集、差集、交集等精确布尔运算,不再有"无法执行操作"的报错。
4.3 导出 SVG:保存为矢量文件
编辑完成后,文件 › 导出 › 导出为,选择.svg。导出由 VectorCraft 自己的渲染管线(crates/svg/)生成,实时效果会按所见保留。
除了手动导出,命令行一行搞定批量转换,这正是一个 SVG 项目最顺手的姿势:
# 把 .vectorcraft 源文件转成 SVG cargo run --release -p vectorcraft-cli -- convert examples/ribbons.vectorcraft out.svg # 查看文件摘要:标题、色彩模式、画板、对象数量、字体 cargo run --release -p vectorcraft-cli -- info examples/dusk-poster.vectorcraft5. 进阶玩法:无头批处理与 AI 驱动
5.1 无头模式:脚本化生成 SVG 项目
run子命令可以按顺序执行命令再导出,适合写脚本批量产出素材:
cargo run --release -p vectorcraft-cli -- run --in examples/ribbons.vectorcraft --export out.pdf cargo run --release -p vectorcraft-cli -- run --in examples/ribbons.vectorcraft --export out.png --scale 2bench子命令还能测量渲染性能:
cargo run --release -p vectorcraft-cli -- bench examples/neon-drive.vectorcraft5.2 MCP 服务器:让 AI Agent 替你画图
VectorCraft 内置 MCP(模型上下文协议)服务器,25 个工具覆盖画图、查文档、导出。注册到 Claude Code 只需一行:
claude mcp add vectorcraft -- ./target/release/vectorcraft-cli mcp之后就可以用自然语言指挥它:画一张爵士音乐节海报、给现有图形换配色、批量导出多格式。完整工具清单见 docs/mcp.md 与控制协议文档 docs/control-protocol.md。
6. 项目资料速查表
| 内容 | 路径 |
|---|---|
| 快速上手命令 | README.md |
| 开发指南(Web 构建、字体、本地化) | docs/development.md |
| MCP 服务器完整文档 | docs/mcp.md |
| 引擎与命令系统 | crates/engine/ |
| SVG 导入导出模块 | crates/svg/ |
| 命令行工具源码 | apps/vectorcraft-cli/src/main.rs |
| 可打开的示例文件 | examples/ |
| 功能路线图 | ROADMAP.md |
7. 常见问题 FAQ
Q:编译报错说 Rust 版本不够?A:VectorCraft 要求 Rust 1.95+(edition 2024),用rustup update stable升级到最新稳定版即可。
Q:没有 macOS 打包版能装吗?A:仓库目前提供 packaging/ 下的各平台打包脚本(Linux deb/rpm/flatpak、macOS .app、Windows WiX),直接cargo run --release -p vectorcraft是最简单的上手方式。
Q:Linux 下拖拽文件进窗口没反应?A:Wayland 会话下 winit 暂不支持拖放,改用复制后粘贴、或文件 › 置入即可,详见 docs/development.md。
Q:界面能换成中文吗?A:可以。VectorCraft 内置简体中文、繁体中文、日语、西班牙语等界面,在编辑 › 首选项 › 用户界面 › 语言里切换。
写在最后
从git clone到cargo run,再到导出一张真正的 SVG 海报,VectorCraft 的完整流程就在 5 分钟之内。它以纯 Rust 实现、MIT/Apache-2.0 双许可发布,crates/ 下每个模块都写得工整清晰,无论你是想用一个免费好用的矢量编辑器,还是想学习一套生产级的 Rust 图形引擎怎么写,这都是一个值得 Star 的项目 🎨
【免费下载链接】vectorcraftAn open-source, clean-room reimplementation of Adobe Illustrator, built in pure Rust.项目地址: https://gitcode.com/gh_mirrors/ve/vectorcraft
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考