Void：可自带模型的开源 AI 代码编辑器（VS Code 二次开发）｜部署与使用全指南
适用读者：想找一个"开源版 Cursor"、把 AI 编程助手接在自己模型/本地模型上的开发者，以及想研究如何 fork VS Code 并加上 React 界面与 AI 能力的同学。特别提醒：官方 README 开篇即声明 Void 已停止维护（deprecated）、不再接受贡献，本文如实记录其现状、最后版本与下载方式，不把它包装成活跃项目。所有信息来自官方 GitHub README 与 Releases 页。需要说明的是：它和你在 VS Code 里装的 Copilot 类扩展不是一个东西——Void 本身就是一个独立的编辑器发行版。
一、项目简介
Void 是一个完整开源的 AI 代码编辑器，本质上是把微软
VS Code 源码（microsoft/vscode）整个 fork
出来，在上面加了一层 AI agent 能力：可以在你的代码库里跑 AI
agent、对改动做 checkpoint 与可视化
diff，并且自带任意模型或本地模型接入。官方 README
的描述是："Use AI agents on your codebase, checkpoint and visualize
changes, and bring any model or host locally. Void sends messages
directly to providers without retaining your data."（在代码库里使用 AI
agent、checkpoint 并可视化改动，可接入任意模型或本地托管；Void
把消息直接发给模型服务商，不留存你的数据。）
当前状态（务必先看）
官方 README 顶部用加粗段落写明：
"Void is now deprecated. Void is deprecated and no longer accepting contributions. …… Void remains open source and is still one of the best references to use when forking VS Code."
也就是说：项目已废弃、不再接受贡献，但源码仍然开源，并且被官方称为"fork
VS Code 时最好的参考之一"。官方同时给出了两个去处：想看更新的衍生
fork，去 github.com/voideditor/void-forks；想下载旧版本
Void，去 Releases 页。
核心信息一览
| 项目 | 内容 |
|---|---|
| 官方仓库 | https://github.com/voideditor/void |
| 官网 | https://voideditor.com |
| 定位 | 开源 AI 代码编辑器，VS Code 的 fork |
| 最后一个 Release | v1.3.4（Releases 页标记为 Latest） |
| 项目状态 | 已废弃（deprecated），不再接受贡献，源码仍开源 |
| 衍生 fork 清单 | https://github.com/voideditor/void-forks |
| 联系 | Discord 服务器 / hello@voideditor.com |
适用场景
- 想要一个不绑定某家商业模型、能接自己模型或本地模型的开源代码编辑器；
- 学习怎么在 VS Code 这套私有构建流程之上，自己打包、签名、自动更新一个发行版；
- 作为 fork VS Code、加入 React UI 与 AI provider 的参考工程来读。
能力边界
- 它不是一个轻量插件，而是整个 VS Code 的发行版 fork，体量与 VS Code 相当；
- 官方已停止维护，不再修 bug、不加新功能，遇到问题只能自己读源码或转去衍生 fork；
- 模型需要你自己配（自带 provider 接入），它不内置模型、不提供托管模型服务。
二、功能特性
来自官方 README 的技术要点：
- 在代码库里跑 AI agent：可以让模型读、写、改你的项目文件；
- 改动 checkpoint 与可视化 diff：通过
EditCodeService把编辑结果以代码流、甚至逐 token 的方式展示成 diff； - 后台编辑与文件同步：
VoidModelService在后台改文件，并把操作系统上的真实文件与编辑器缓冲区做同步； - 自带模型/本地模型：消息直发模型服务商，不留存你的数据；
- 从零写的 AI provider
层：支持自动补全（FIM，Fill-in-the-middle）以及其他自定义响应；暴露了对常见
<thinking>标签、工具标签等的语法支持； - React + Tailwind 界面：在纯 VS Code 里做不到，Void 扩展了构建流水线，自己编译 React 并用 scope-tailwind 处理 Tailwind；
- 打包/签名/自动更新：把 GitHub Actions 整套流程开源出来，因为 VS Code 的构建流程是私有的，自己做很难；
- IPC 与 CSP：提供了一套满足内容安全策略的进程间通信架构，可参考。
它和"在 VS Code 里装一个 AI 插件"不是一回事：普通做法是保留微软官方 VS Code、再装 Copilot 类扩展；Void 是把 VS Code 源码整个 fork、连 UI 一起重做（React + Tailwind），连打包签名自动更新那套原本私有的 CI 都开源了。所以它更像"一个独立发行的编辑器"，而不是你现有 VS Code 里的一个插件——你不能把 Void 装进官方 VS Code，它本身就是编辑器。
三、官方界面预览
官方 README
内嵌的欢迎图就是题图——一个悬浮的黑色立方体（slice_of_void.png），是
Void 编辑器首次启动时的欢迎/品牌图。README
未附带实际编辑界面的截图，因此本节只展示官方品牌图，不脑补界面。
四、官方链接汇总
五、前置要求
对普通用户（只想用）：
- 一个受支持的桌面系统（macOS / Windows / Linux，具体安装包以 Releases 页提供的资产为准）；
- 一个你自己的模型服务：可以是本地模型（本地推理），也可以是任意兼容的模型 API——Void 不替你托管模型。
对想从源码构建/二次开发的人：
- 需要能构建 VS Code 这类大型 Electron/Monorepo
工程的开发环境（具体依赖版本以仓库
HOW_TO_CONTRIBUTE.md与void-builder工具链为准，README 未在正文中罗列）； - 官方明确：VS Code 自带的构建流水线是私有的，Void 通过扩展流水线才得以编译 React 与 Tailwind，并复制了其 GitHub Actions 来打包、签名与自动更新。
六、安装部署
普通用户：下载旧版本安装包
- 打开 Releases 页：https://github.com/voideditor/void/releases ；
- 找到标记为 Latest 的最新发行版（当前为 v1.3.4）；
- 在该版本 Assets 里下载对应你操作系统的安装包；
- 按系统常规方式安装（macOS 拖进 Applications、Windows 运行安装器、Linux 用对应包/解压运行）。
官方 README 原话："To download an old version of Void, see Releases." 即 Releases 是获取旧版本 Void 的官方渠道。
开发者：从源码构建
官方不建议普通用户从源码跑，但如果你要 fork 或二次开发：
# 克隆整个 Void（VS Code fork）仓库
git clone https://github.com/voideditor/void
cd void随后阅读官方两份文档再动手：
VOID_CODEBASE_GUIDE.md：代码库结构导览；HOW_TO_CONTRIBUTE.md：如何开发自己的 Void 版本；- 配套构建工具
void-builder（见官方仓库列表）。
七、配置项说明
Void 的核心理念是"bring any model or host locally"（自带任意模型或本地托管），因此配置重心在模型 provider：
- 模型来源：你自己选——本地模型服务，或任意兼容的模型 API；Void 把消息直发服务商，不中转、不留存；
- 自动补全（FIM）：由其自写的 provider 层支持，需要在设置里指定用于补全的模型；
<thinking>/ 工具标签语法：内置了常见思考标签、工具标签的语法支持，便于展示模型的思考过程与工具调用；- 不存数据：官方强调消息直接发给 provider，不经 Void 自己的服务器留存。
具体设置项名称与填写方式以你下载版本里的应用内设置面板为准；由于项目已停更，README 正文未提供逐项配置表，本文不臆造字段名。
隐私这一点值得单独说：官方 README 强调"Void sends messages directly to providers without retaining your data"——它把你的代码上下文直接发给你配置的那个模型服务商，中间不经 Void 自己的服务器留存。这意味着隐私边界取决于你选的模型服务商：接本地模型就完全不出本机，接云端 API 则按那家服务商的隐私政策来。
八、使用流程
- 从 Releases 安装 v1.3.4（或你选择的旧版本）并启动；
- 首次进入后，在设置里配置你自己的模型 provider / 本地模型地址；
- 打开一个本地代码文件夹，像用 VS Code 一样编辑；
- 唤起 AI agent，让它在代码库里做改动，diff 会以代码流形式逐段展示；
- 对 AI 给出的 diff
逐块接受或拒绝；编辑在后台进行时，
VoidModelService会同步磁盘文件与编辑器缓冲区。
关于后续选择：如果你只是想要"开源 + 自带模型"的编辑器体验，又在意持续维护，官方 README 直接指路
voideditor/void-forks——那是 Void 团队维护的一份衍生 fork 清单，里面是社区基于 Void 继续做的新版本。本文建议你先看一眼那份清单再决定是用停更的 v1.3.4，还是直接上仍在更新的 fork。
九、常用运维 / 更新命令
# 源码方式跟踪（仅开发者）
git pull
# 查看官方给出的最新衍生 fork（官方推荐去向）
# 浏览器打开 https://github.com/voideditor/void-forks普通用户不需要手动更新：官方已停更，Releases 上不会再有新版本；想继续获得维护，请按官方指引迁移到 void-forks 列表里的某个活跃衍生版本。
十、常见故障排查
| 现象 | 原因与处理 |
|---|---|
| 在 Releases 找不到新版本 | 官方已 deprecated，最新就是 v1.3.4 附近，这是预期，不是你网络问题 |
| 担心没人修 bug | 这是停更项目的固有风险；官方建议转去 void-forks 找活跃 fork |
| AI 补全/对话不工作 | 多半是模型 provider 没配对，检查你填的模型地址与 Key；Void 不内置模型 |
| 想自己改源码 | 先读 VOID_CODEBASE_GUIDE.md 与 HOW_TO_CONTRIBUTE.md，别直接按 VS Code 的构建方式套 |
| 签名/安全提示 | 旧版本自签名/未签名安装包在新系统上可能被拦，确认来源是官方 Releases 后再决定是否放行 |
| 想要最新功能 | 官方已停更，Void 本体不会有新功能；直接去 void-forks 清单找活跃 fork，那里才是社区继续开发的地方 |
| 本地模型连不上 | 确认本地模型服务已启动、监听地址与端口正确，并在 Void 的 provider 设置里填对；Void 不负责帮你拉起模型 |
十一、风险与责任使用声明
- 本文版本号（最后 Release v1.3.4）、技术特性（React+Tailwind、FIM、EditCodeService/VoidModelService、IPC+CSP）、链接均来自官方 README 与 Releases 页；
- Void 已被官方声明为 deprecated、不再接受贡献，请基于这一事实评估是否用于日常主力开发；生产关键项目建议优先选择仍在维护的编辑器/插件，并自行评估停更带来的安全与兼容风险；
- 它直连你配置的模型服务商，请自行保管 API Key、理解所选模型服务的隐私与计费政策；Void 声明不留存你的数据，但你仍需自行验证；
- 项目按开源方式提供（具体许可证以仓库 LICENSE 为准），按"AS IS"使用，风险自负；本文不托管、不代理 Void，也不推荐任何特定衍生 fork。