字节笔记本
2026年2月23日
Void:开源的 Cursor 替代方案 - AI 驱动代码编辑器
Void 是一款开源的 AI 驱动代码编辑器,作为 Cursor 的开源替代品,它允许开发者使用 AI 代理处理代码库、可视化代码变更,并支持本地部署任意模型。本文将详细介绍 Void 的核心特性、技术架构和使用方法。
项目简介
Void 是基于 VS Code fork 的开源项目,由 Void Editor 团队开发维护。截至目前,该项目在 GitHub 上已获得 28.2k+ stars,主要使用 TypeScript (95.3%) 编写,辅以 CSS、JavaScript 和 Rust。
与 Cursor 等商业 AI 编辑器不同,Void 的核心理念是:
- 完全开源:代码完全透明,社区可自由贡献
- 数据隐私:消息直接发送给 AI 提供商,Void 不保留任何数据
- 模型自由:支持任意模型和本地托管方案
核心特性
1. AI 代理功能
Void 内置强大的 AI 代理能力,可以:
- 在代码库上执行复杂的 AI 驱动任务
- 自动分析和理解项目结构
- 智能代码补全和生成
2. 代码变更可视化
- Checkpoint 机制:保存代码变更的关键节点
- 可视化对比:直观展示 AI 修改前后的差异
- 版本回退:随时回到之前的代码状态
3. 多模型支持
Void 不绑定特定 AI 提供商,支持:
- OpenAI GPT 系列
- Anthropic Claude 系列
- 本地模型(通过 Ollama 等)
- 任意兼容 OpenAI API 的端点
4. 隐私优先
- 所有请求直接发送到用户配置的 AI 提供商
- Void 服务器不存储任何代码或对话数据
- 支持完全离线的本地模型部署
技术栈
| 技术 | 占比 | 用途 |
|---|---|---|
| TypeScript | 95.3% | 核心编辑器逻辑、UI 组件 |
| CSS | 1.4% | 样式和主题 |
| JavaScript | 1.2% | 脚本和配置 |
| Rust | 0.7% | 性能关键模块 |
| HTML | 0.5% | 模板和界面 |
Void 基于 VS Code 的成熟架构,继承了其强大的扩展生态和编辑器内核。
安装指南
下载预构建版本
访问 Void 官网 下载适用于您系统的安装包:
- macOS (Apple Silicon / Intel)
- Windows (x64 / ARM64)
- Linux (x64 / ARM64)
从源码构建
前置要求
- Node.js 20.18.2(推荐使用 nvm 管理)
- Python 3
- Git
macOS 额外要求:Xcode Command Line Tools
Windows 额外要求:Visual Studio 2022 或 VS Build Tools,需安装:
- Desktop development with C++
- Node.js build tools
- MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs
Linux 额外要求:
# Debian/Ubuntu
sudo apt-get install build-essential g++ libx11-dev libxkbfile-dev libsecret-1-dev libkrb5-dev python-is-python3
# Fedora
sudo dnf install @development-tools gcc gcc-c++ make libsecret-devel krb5-devel libX11-devel libxkbfile-devel
# openSUSE
sudo zypper install patterns-devel-C-C++-devel_C_C++ krb5-devel libsecret-devel libxkbfile-devel libX11-devel构建步骤
# 1. 克隆仓库
git clone https://github.com/voideditor/void
cd void
# 2. 安装依赖
npm install
# 3. 初始化开发模式(按 Cmd/Ctrl+Shift+B)
# 等待编译完成(约 5 分钟)
# 4. 启动 Void 开发窗口
# macOS/Linux:
./scripts/code.sh
# Windows:
./scripts/code.bat快速开始
配置 AI 提供商
首次启动 Void 后,需要配置 AI 模型:
- 打开设置(Cmd/Ctrl + ,)
- 搜索 "Void" 找到 AI 配置选项
- 添加您的 API 密钥:
- OpenAI API Key
- Anthropic API Key
- 或自定义端点 URL
使用 AI 功能
Void 提供多种 AI 交互方式:
内联编辑:
- 选中代码,按
Cmd/Ctrl + K - 输入自然语言指令,如"优化这段代码的性能"
侧边栏对话:
- 打开 Void 面板(通常位于左侧)
- 与 AI 进行连续对话,讨论代码问题
代码生成:
- 在编辑器中按
Cmd/Ctrl + L - 描述需要生成的代码功能
本地模型部署
Void 支持通过 Ollama 使用本地模型:
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型
ollama pull codellama
ollama pull llama3
# 在 Void 中配置本地端点
# 设置 URL 为 http://localhost:11434开发指南
项目结构
Void 的主要代码位于 src/vs/workbench/contrib/void/ 目录:
void/
├── src/vs/workbench/contrib/void/ # Void 核心功能
│ ├── browser/ # UI 组件
│ ├── common/ # 共享逻辑
│ └── electron-sandbox/ # 桌面端功能
├── extensions/ # 内置扩展
├── build/ # 构建脚本
└── scripts/ # 开发工具开发工作流
# 1. 修改代码后,在开发窗口中按 Cmd/Ctrl+R 重新加载
# 2. 监视模式构建(终端)
npm run watch
# 3. 构建生产版本
npm run gulp vscode-darwin-arm64 # macOS ARM
npm run gulp vscode-win32-x64 # Windows x64
npm run gulp vscode-linux-x64 # Linux x64常见问题解决
构建错误:
- 确保 Node 版本为 20.18.2:
nvm install && nvm use - 路径不能包含空格
- 确保使用 GNU libtool(macOS 默认是 BSD)
运行时错误:
# SUID sandbox 错误
sudo chown root:root .build/electron/chrome-sandbox
sudo chmod 4755 .build/electron/chrome-sandbox内存不足:
NODE_OPTIONS="--max-old-space-size=8192" npm run buildreact项目状态说明
⚠️ 重要提示:Void 团队已暂停对 Void IDE 的主动开发,以探索新的编程工具理念。在此期间:
- Void 仍可正常使用
- 但部分功能可能随时间推移而失效
- 团队仍会回复邮件咨询(hello@voideditor.com)
- 社区可以继续维护和 fork 项目
相关资源
- GitHub 仓库:voideditor/void
- 官方网站:voideditor.com
- Discord 社区:加入讨论
- 项目看板:Roadmap
- 代码指南:VOID_CODEBASE_GUIDE.md
- 贡献指南:HOW_TO_CONTRIBUTE.md
- 构建工具:void-builder
许可证
Void 采用 Apache 2.0 许可证开源,基于 VS Code 的 MIT 许可证版本 fork。
Void 代表了 AI 辅助编程工具的开源替代方案,为注重隐私和代码透明度的开发者提供了一个值得尝试的选择。尽管目前处于维护暂停状态,但其开源特性允许社区继续发展和改进这个项目。