欢迎来到 Void。

Void 是一款开源的 Cursor 替代工具。

您可以在自己的代码库上使用 AI 代理，保存和可视化更改，并将任何模型或服务端本地化运行。Void 会直接向提供商发送请求，而不会保留您的数据。

本仓库包含了 Void 的完整源代码。如果您是新用户，欢迎加入！

• 🧭 官网

• 👋 Discord

• 🚙 项目看板

注意事项

我们已暂停对 Void IDE（即此仓库）的开发，以便探索一些新颖的编程理念。我们希望专注于创新，而非单纯追求功能上的完全对等。Void 仍将继续运行，但由于缺乏维护，部分现有功能可能会随时间逐渐失效。根据我们新工作的方向，我们可能不会恢复 Void 作为一款 IDE。

在此期间，我们将不再主动审核 Issues 和 PR，但我们会回复所有通过 email 发来的关于构建和维护您自己的 Void 版本的问题。

参考资料

Void 是 vscode 仓库的一个分支。如需了解代码库的结构，请参阅 VOID_CODEBASE_GUIDE。

如需了解如何开发您自己的 Void 版本，请参阅 HOW_TO_CONTRIBUTE 和 void-builder。

支持

您随时可以通过我们的 Discord 服务器联系我们，或发送邮件至 hello@voideditor.com。

Void 快速上手指南

Void 是一款开源的 AI 代码编辑器，被视为 Cursor 的替代方案。它支持在本地代码库上使用 AI 代理、检查点管理及变更可视化，并允许用户接入任意模型或本地部署的服务。Void 直接将消息发送至提供商，不保留用户数据。

⚠️ 重要提示：目前开发团队已暂停对 Void IDE（本仓库）的功能迭代，转而探索新的编码理念。现有版本仍可运行，但部分功能可能随时间失效，且官方不再主动审查 Issue 和 PR。如需构建或维护自有版本，可通过邮件 hello@voideditor.com 联系团队获取支持。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：建议安装 LTS 版本（参考 VS Code 构建要求，通常需 v18+）
• Git：用于克隆源代码仓库
• 依赖工具：
  • Python (部分脚本可能需要)
  • Yarn 或 npm (推荐使用项目指定的包管理器)
• 内存：建议至少 8GB RAM，编译过程较为消耗资源

安装步骤

由于 Void 是 VS Code 的分支，目前主要通过源码构建的方式安装。

1. 克隆仓库 打开终端，执行以下命令拉取源代码：

   git clone https://github.com/voideditor/void.git
   cd void
   

2. 安装依赖 进入目录后安装项目依赖（根据项目具体配置，通常使用 yarn）：

   yarn install
   

   注：若国内网络下载依赖缓慢，可配置淘宝镜像源：

   yarn config set registry https://registry.npmmirror.com
   yarn install
   

3. 构建与运行 使用以下命令启动开发版本的 Void：

   yarn watch
   

   在另一个终端窗口中运行：

   ./scripts/code.sh
   

   (Windows 用户请运行 .\scripts\code.bat)

   若需构建生产版本安装包，请参考官方文档 HOW_TO_CONTRIBUTE 及 void-builder 项目。

基本使用

启动 Void 后，其操作逻辑与 VS Code 高度相似，主要区别在于集成了原生的 AI 工作流：

1. 打开项目 启动应用后，通过 File -> Open Folder 打开您的代码项目。

2. 配置 AI 模型 进入设置界面，配置您偏好的 AI 提供商（Provider）和 API Key。Void 支持连接多种模型或本地托管的 LLM。

3. 使用 AI 代理 在编辑器侧边栏或命令行面板中调用 AI 功能：

   • 代码生成/修改：选中代码段，使用快捷键呼出 AI 对话框，输入指令让 Agent 直接修改代码。
   • 变更可视化：利用 Checkpoint 功能查看 AI 对代码库做出的更改历史，并可随时回滚。

4. 隐私保护 确认设置中已开启“不保留数据”选项，所有请求将直接转发至模型提供商，Void 服务端不存储任何代码片段。

如需深入了解代码库结构或参与二次开发，请参阅 VOID_CODEBASE_GUIDE。