voideditor/void · 上手攻略
- 仓库：voideditor/void
- 链接：https://github.com/voideditor/void
- 分类：AI Coding · AI IDE
- 作者：Jay
- 更新：2026-07-15
是什么
Void 是一个基于 VS Code 的开源 AI 代码编辑器，由 YC 支持的初创公司 Glass Devtools 开发。它在 VS Code 基础上引入了 AI Agent 能力——支持在代码库上运行 AI Agent、Checkpoint 可视化、以及任意模型或 API 的本地接入。数据直接发送给提供商，不在 Void 侧留存。
⚠️ 重要状态：Void 已于 2025 年中暂停开发，不再接受新贡献（"deprecated"）。最后代码提交为 2025 年 8 月 4 日，最后二进制版本为 v1.99.30044（2025 年 6 月 23 日）。项目仍开源可免费使用，但不再更新。进阶替代品包括 Cursor（商业）、Cline 等。
解决什么问题
VS Code 本身没有原生 AI 能力，而闭源 AI IDE（如 Cursor）价格高昂且依赖自有模型。Void 的目标是：
- 提供完全开源的 AI 代码编辑器，基于熟悉的 VS Code 界面
- 支持任意 LLM 提供商（OpenAI、Anthropic、本地模型等），数据不经过 Void 服务端
- 支持在代码库上运行 AI Agent、checkpoint 追踪和变更可视化
- 为想 fork VS Code 的开发者提供参考实现
快速安装
下载预编译二进制（推荐，适合直接使用）
- 前往 Releases 页面 下载最新版本（macOS / Linux / Windows）
- 解压后直接运行，无需安装
最后可用版本：v1.99.30044（2025-06-23）
从源码构建（需要 Node.js + Rust）
# 克隆源码
git clone https://github.com/voideditor/void.git
cd void
# 安装依赖
pnpm install
# 编译原生组件（需要 Rust）
make -C native/zero-c
# 运行
bin/void --version
agent bootstrap skill（AI Agent 接入用）
npx skills add voideditor/void
核心用法
启动与基础配置
# 启动 Void（预编译版）
./Void-{版本号}.AppImage # Linux
./Void-{版本号}.dmg # macOS
首次启动后，需要在设置中配置 AI Provider（API Key、模型选择等）。
AI Provider 配置
Void 从零实现了 AI Provider 代码，支持： - FIM（Fill-in-Middle）自动补全 - 自定义流式响应 - IPC 通信与 CSP 兼容
支持的提供商（需自行填入 API Key）：
| 提供商 | 配置路径 |
|---|---|
| OpenAI | Settings → AI → OpenAI |
| Anthropic | Settings → AI → Anthropic |
| 本地 Ollama | Settings → AI → Ollama |
| 自定义 API | Settings → AI → Custom |
AI Agent 使用
Void 的 Agent 能力由以下自建服务实现：
- EditCodeService：后台编辑文件，支持 token 级 diff 流显示
- VoidModelService：后台模型交互，同步 OS 文件与文本缓冲区
典型 Agent 工作流： 1. 在侧边栏打开 Agent 面板 2. 输入自然语言任务（如"为这个函数写单元测试"） 3. Agent 分析代码并提交编辑 4. 可随时 checkpoint，回滚到任意版本
文件编辑与同步
# Void 内置的文件服务会自动同步编辑结果
# 正常在编辑器内操作即可，文件变更实时落盘
导出与查看变更
Void 的变更记录以 checkpoint 形式保存，可在 UI 内可视化浏览diff。
典型适用场景
- 想用 AI IDE 但不想付费：Void 完全免费开源，基于熟悉的 VS Code 界面
- 需要数据隐私：请求不经过 Void 服务端，直接发给用户配置的提供商
- 研究 VS Code fork 技术：Void 的代码库指南（VOID_CODEBASE_GUIDE.md）和贡献指南对学习者很有价值
- AI Agent 开发参考：EditCodeService、VoidModelService 等实现可作为自建 AI 编程工具的参考
坑与注意
- ⚠️ 项目已停止维护：不要再期望新功能或 bug 修复，2025 年中已 formal deprecated
- 版本落后：最后发布是 2025 年 6 月，VS Code 上游已有大量变更，可能存在兼容性问题
- 无安全更新：deprecated 后没有收到安全补丁，使用时注意网络隔离
- 生态不如 Cursor/Cline：没有 MCP 生态、没有 agent 并行执行（Cursor 3 支持 8 个并行 agent）
- 构建门槛高：从源码构建需要 Rust 工具链，不如直接下载二进制
与同类对比
| 工具 | 类型 | 开源 | 价格 | 最后更新 | AI Agent | MCP |
|---|---|---|---|---|---|---|
| Void | VS Code fork | ✅ MIT | 免费 | 2025-06 | ✅ | ❌ |
| Cursor | 商业 IDE | ❌ | $20+/月 | 活跃 | ✅ 多 agent | ✅ |
| Cline | VS Code 插件 | ✅ | 免费 | 活跃 | ✅ | ✅ |
| VS Code + Copilot | 官方插件 | ❌ | $10+/月 | 活跃 | 有限 | 有限 |
| Continue | 开源 IDE | ✅ | 免费 | 活跃 | ✅ | ✅ |
一句话推荐结论
Void 是一个有诚意、有技术含量的开源 AI IDE 尝试——但已于 2025 年中冻结，不推荐作为主力工具，更适合作为学习 VS Code fork 和 AI 编程工具架构的技术参考资料。若需要活跃的开源替代，推荐转向 Cline（插件）或 Continue（IDE）。