字节笔记本

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 服务器不存储任何代码或对话数据
  • 支持完全离线的本地模型部署

技术栈

技术占比用途
TypeScript95.3%核心编辑器逻辑、UI 组件
CSS1.4%样式和主题
JavaScript1.2%脚本和配置
Rust0.7%性能关键模块
HTML0.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 额外要求

bash
# 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

构建步骤

bash
# 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 模型:

  1. 打开设置(Cmd/Ctrl + ,)
  2. 搜索 "Void" 找到 AI 配置选项
  3. 添加您的 API 密钥:
    • OpenAI API Key
    • Anthropic API Key
    • 或自定义端点 URL

使用 AI 功能

Void 提供多种 AI 交互方式:

内联编辑

  • 选中代码,按 Cmd/Ctrl + K
  • 输入自然语言指令,如"优化这段代码的性能"

侧边栏对话

  • 打开 Void 面板(通常位于左侧)
  • 与 AI 进行连续对话,讨论代码问题

代码生成

  • 在编辑器中按 Cmd/Ctrl + L
  • 描述需要生成的代码功能

本地模型部署

Void 支持通过 Ollama 使用本地模型:

bash
# 安装 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/ 目录:

text
void/
├── src/vs/workbench/contrib/void/    # Void 核心功能
│   ├── browser/                      # UI 组件
│   ├── common/                       # 共享逻辑
│   └── electron-sandbox/             # 桌面端功能
├── extensions/                       # 内置扩展
├── build/                           # 构建脚本
└── scripts/                         # 开发工具

开发工作流

bash
# 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)

运行时错误

bash
# SUID sandbox 错误
sudo chown root:root .build/electron/chrome-sandbox
sudo chmod 4755 .build/electron/chrome-sandbox

内存不足

bash
NODE_OPTIONS="--max-old-space-size=8192" npm run buildreact

项目状态说明

⚠️ 重要提示:Void 团队已暂停对 Void IDE 的主动开发,以探索新的编程工具理念。在此期间:

  • Void 仍可正常使用
  • 但部分功能可能随时间推移而失效
  • 团队仍会回复邮件咨询(hello@voideditor.com
  • 社区可以继续维护和 fork 项目

相关资源

许可证

Void 采用 Apache 2.0 许可证开源,基于 VS Code 的 MIT 许可证版本 fork。


Void 代表了 AI 辅助编程工具的开源替代方案,为注重隐私和代码透明度的开发者提供了一个值得尝试的选择。尽管目前处于维护暂停状态,但其开源特性允许社区继续发展和改进这个项目。

分享: