Void 编辑器新手上手指南接入任意大模型让 AI 直接改你的代码【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/voidVoid 是一款开源的 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然后在编辑器里按CtrlShiftBmacOS 为CmdShiftB触发构建任务等两个转圈变成对勾约 5 分钟再运行./scripts/code.shWindows 为./scripts/code.bat打开开发者模式的窗口。如何判断成功构建日志出现Finished compilation ... with 0 errors即编译通过。新窗口打开后按CtrlR重载侧边栏能看到 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.tsCmdK快速编辑、Agent 的 Edit 工具走的也是同一套逻辑只是作用区域不同。3. 接入任意模型包括本地模型设置页支持 15 家 Provider云端有 OpenAI、Anthropic、Gemini、DeepSeek、OpenRouter 等本地有 Ollama默认端点http://127.0.0.1:11434、LM Studiohttp://localhost:1234、vLLMhttp://localhost:8000等。本地 Provider 的模型列表是自动探测的本机服务起来后编辑器会自动列出可用模型。想加新模型改 src/vs/workbench/contrib/void/common/modelCapabilities.ts 这个文件即可。关键路径与入口找文件先看这几处你想做的事去哪里看读懂整体架构VOID_CODEBASE_GUIDE.md本地编译与常见报错修复HOW_TO_CONTRIBUTE.mdAI 功能源码侧边栏、聊天、Apply、设置src/vs/workbench/contrib/void/Provider 与模型清单modelCapabilities.ts语言、主题等内置扩展extensions/编辑器核心工作台、文本编辑器src/vs/workbench/、src/vs/editor/一个规律browser/目录里的代码跑在渲染进程用户界面那一侧electron-main/里的代码跑在主进程Node 环境那一侧LLM 请求就是从这一侧发出的common/是两边共用的类型和服务。按这个规律找文件比按目录名猜测更快。常见误区与排错Node 版本不对导致编译报错用nvm install nvm use切到 20.18.2不要依赖系统全局版本。本地 Provider 连不上先确认 Ollama/LM Studio 服务已启动、端口和modelCapabilities.ts里的默认端点一致本地模型是自动探测的服务没起来列表就是空的。改了代码没生效开发者模式下必须按CtrlR或执行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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考