Void 编辑器新手上手指南：接入任意大模型，让 AI 直接改你的代码

Void 编辑器新手上手指南：接入任意大模型，让 AI 直接改你的代码

【免费下载链接】void开源AI代码编辑器，Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void

Void 是一款开源的 AI 代码编辑器，可以理解为一个自带 AI 侧边栏的 VS Code 分支（fork）。它把 AI 消息直接发给你自己配置的模型提供商，不经过中间商，适合想用自己的 API Key、甚至本地模型来写代码的开发者。读完本文，你会知道它适合谁、第一次怎么跑起来、AI 功能的关键入口在哪里。

先判断：Void 是否适合你现在使用

适合的场景

• 你不想让代码经过第三方云端中转，希望消息直连 OpenAI、Anthropic 或本地的 Ollama、LM Studio 等模型服务。
• 你希望 AI 修改代码前先以红绿 diff（差异对比）展示出来，由你决定是否接受。
• 你熟悉 VS Code 的操作习惯，想要一个可以改源码的 AI 编辑器。

需要知道的限制

• Void 官方已在 README 中声明：Void IDE 的开发已暂停，团队在探索新的方向。也就是说，它还能用，但不再有人维护，部分功能可能随时间失效，Issue 和 PR 也不会被积极处理。
• 如果你只是想要一个稳定维护的 AI 编辑器，而不是想折腾源码，可以先观望，或优先使用已发布的成品版本。
• 本文主要面向两类读者：想本地跑起 Void 的普通用户，以及想读懂/修改 AI 功能源码的开发者。

第一次使用：最短上手路径

前置条件

• Node.js 20.18.2（仓库里的 .nvmrc 写死了这个版本，建议用 nvm 安装）。
• Linux 用户需要 C/C++ 编译工具链，具体包名见 HOW_TO_CONTRIBUTE.md 的 Prerequisites 一节。
• 仓库路径里不要带空格，否则编译容易出问题。

最小步骤

git clone https://gitcode.com/GitHub_Trending/void2/void cd void && npm install

然后在编辑器里按Ctrl+Shift+B（macOS 为Cmd+Shift+B）触发构建任务，等两个转圈变成对勾（约 5 分钟），再运行./scripts/code.sh（Windows 为./scripts/code.bat）打开开发者模式的窗口。

如何判断成功

• 构建日志出现Finished compilation ... with 0 errors即编译通过。
• 新窗口打开后，按Ctrl+R重载；侧边栏能看到 AI 对话入口，并且可以进入设置页填 Provider 和模型，就说明环境可用。

核心能力：AI 功能如何落到实际操作里

1. 聊天与 Agent 模式

侧边栏（sidebar）是 AI 的主入口。设置里为聊天（Chat）选择的功能模式有三种：普通对话、gather（先收集上下文）、agent（让模型自主执行多步操作）。如果你只关心"让 AI 帮我改代码"，用 agent 模式；只想提问或解释代码，用普通模式即可。

2. 代码改动以 Diff 形式呈现，可接受或放弃

这是 Void 与普通"复制粘贴 AI 输出"最大的区别。点击 Apply（应用）后，AI 的修改会以红绿区域显示在文件里，你可以逐段审阅。底层有两种策略：

• Fast Apply：让模型只输出"查找/替换"代码块，适合大文件，速度快；
• Slow Apply：整体重写文件，适合改动面大的场景。

对应源码是 src/vs/workbench/contrib/void/browser/editCodeService.ts，Cmd+K快速编辑、Agent 的 Edit 工具走的也是同一套逻辑，只是作用区域不同。

3. 接入任意模型，包括本地模型

设置页支持 15 家 Provider，云端有 OpenAI、Anthropic、Gemini、DeepSeek、OpenRouter 等，本地有 Ollama（默认端点http://127.0.0.1:11434）、LM Studio（http://localhost:1234）、vLLM（http://localhost:8000）等。本地 Provider 的模型列表是自动探测的：本机服务起来后，编辑器会自动列出可用模型。想加新模型，改 src/vs/workbench/contrib/void/common/modelCapabilities.ts 这个文件即可。

关键路径与入口：找文件先看这几处

一个规律：browser/目录里的代码跑在渲染进程（用户界面那一侧），electron-main/里的代码跑在主进程（Node 环境那一侧，LLM 请求就是从这一侧发出的），common/是两边共用的类型和服务。按这个规律找文件，比按目录名猜测更快。

常见误区与排错

• Node 版本不对导致编译报错：用nvm install && nvm use切到 20.18.2，不要依赖系统全局版本。
• 本地 Provider 连不上：先确认 Ollama/LM Studio 服务已启动、端口和modelCapabilities.ts里的默认端点一致；本地模型是自动探测的，服务没起来列表就是空的。
• 改了代码没生效：开发者模式下必须按Ctrl+R或执行Reload Window重载窗口。
• 报Failed to fetch dynamically imported module：检查 import 语句是否以.js结尾，这是 VSCode 源码体系的惯例。
• 期望官方长期维护：如前所述，Void IDE 已暂停开发，做生产选型前请先读 README.md 的 Note 部分。

继续深入

• 想自己改 Void：完整流程在 HOW_TO_CONTRIBUTE.md，架构原理（LLM 消息管线、Apply 内部机制、设置服务）在 VOID_CODEBASE_GUIDE.md。
• 想理解 AI 侧边栏的界面代码：从 src/vs/workbench/contrib/void/browser/react/ 的sidebar-tsx和quick-edit-tsx目录入手，它们是 React 写的组件。
• 想给某个语言加语法支持：参考 extensions/ 下任意一个语言扩展（如 extensions/rust/）的结构，照抄目录组织即可。

第一次跑通后，建议先把本地 Ollama 接上跑一轮 agent 模式，观察 diff 审阅的完整流程——这条路径覆盖了 Void 最核心的价值，也是你后续改源码时最值得先弄懂的部分。

【免费下载链接】void开源AI代码编辑器，Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void