项目介绍

你是否在使用 GitHub Copilot 或 Cursor 的时候，觉得它们的智能补全虽然强大，但总有些地方不尽如人意？比如，价格高昂，或者一些功能限制让人抓狂？今天介绍一款新工具——Void，这款编辑器号称是开源的 Cursor 和 GitHub Copilot 替代品，而且完全免费！

在你的代码库中使用 AI 代理，检查点并可视化更改，并将任何模型或主机本地化。Void 直接向提供者发送消息，而不会保留你的数据。拥有与 Cursor 几乎一样强大的编程功能，最大的不同 Void 是可直接连接任何 AI 模型或使用本地部署模型，无需再经过第三方服务器。

基于 VS Code 开发，可一键导入原有主题、快捷键和设置，对于已习惯 VS Code 编辑器的开发者来说颇为友好。

主要功能

• • 按 Tab 键智能补全代码，支持内联编辑（Ctrl+K），操作体验超流畅；
• • 强大的 Agent 模式可搜索、创建、编辑文件，甚至有终端访问权限；
• • 独特的 Gather 模式提供只读搜索功能，更安全地分析代码库；
• • Checkpoints 功能可视化 AI 代码修改，轻松追踪和比较所有变更；
• • 即使不支持工具调用的开源模型，也能在 Agent 模式下使用；
• • 智能代码错误检测，AI 能主动发现并修复代码问题；
• • 超快速应用功能，即使对 1000 行大文件也能即时生效。

如何上手 Void？

说了这么多，可能你已经有点心动了。那该如何开始使用 Void 呢？其实步骤非常简单。

• • 首先，访问 Void 的官网，下载适用于你系统的安装包,没有加白的先申请白名单。
• • 安装完成后，按照文档配置好开发环境。如果你是 VSCode 用户，Void 可以无缝集成，使用起来几乎没有学习成本。
• • 开启编辑器，开始写代码吧！在你键入几行代码后，Void 会自动为你提供补全建议，你可以根据需求接受或者忽略它的建议。

如何构建

Mac - 构建前提

需安装 Python 和 XCode（通常已默认安装）。

Windows - 构建前提

1. 1. 安装 Visual Studio 2022（推荐）或 VS Build Tools。
2. 2. 在“工作负载”选项卡中勾选：

• • Desktop development with C++
• • Node.js build tools

• 3. 在“单个组件”选项卡中勾选：
• • MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
• • C++ ATL for latest build tools with Spectre Mitigations
• • C++ MFC for latest build tools with Spectre Mitigations
• 4. 点击安装。

Linux - 构建前提

1. 1. 运行 npm install -g node-gyp。
2. 2. 根据系统选择以下命令：
• • 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。
• • 其他系统：参考 VSCode 贡献指南。

在 VSCode 中构建 Void

1. 1. git clone https://github.com/voideditor/void
2. 2. npm install
3. 3. 在 VSCode 中按：
• • Windows/Linux：Ctrl+Shift+B
• • Mac：Cmd+Shift+B
• • 构建约需 5 分钟，完成后会显示两个勾选标记。
• 4. 运行 Void：
• • Windows：./scripts/code.bat
• • Mac/Linux：./scripts/code.sh

小技巧：

• • 按 Ctrl+R（Mac 为 Cmd+R）快速重载窗口。
• • 添加 --user-data-dir ./.tmp/user-data --extensions-dir ./.tmp/extensions 参数可重置测试环境（删除 .tmp 文件夹即可）。

终端构建

运行 npm run watch，完成时会显示类似以下信息：

[watch-extensions] Finished compilation extensions with 0 errors after 19303 ms  
[watch-client] Finished compilation with 0 errors after 46248 ms  

常见问题

• • 确保 Node 版本为 20.18.2（使用 nvm install 和 nvm use 切换）。
• • 路径中不要包含空格。
• • 若出现 TypeError: Failed to fetch dynamically imported module，检查导入语句是否以 .js 结尾。
• • React 错误尝试运行 NODE_OPTIONS="--max-old-space-size=8192" npm run buildreact。

---

打包

通常不建议打包，直接构建即可。若需生成可执行文件，运行以下命令（约需 25 分钟）：

Mac：

• • Apple Silicon：npm run gulp vscode-darwin-arm64
• • Intel：npm run gulp vscode-darwin-x64

Windows：

• • 主流：npm run gulp vscode-win32-x64

Linux：

• • 主流：npm run gulp vscode-linux-x64

输出路径：

workspace/  
├── void/          # 你的 Void 仓库  
└── VSCode-darwin-arm64/  # 生成的打包文件