快速上手Void编辑器本地构建、接入AI模型与扩展开发的完整实操路径【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void你手里有 Ollama 本地模型也有几张云端 API Key想找一个不锁死供应商、消息直连模型提供商的开源 AI 代码编辑器。Void 编辑器就是为这个场景而生的 Cursor 替代方案——克隆仓库、启动开发者模式、接入模型三个步骤之后你就能在自己的代码库上对话、补全和一键改码。三步克隆并启动Void开发者模式Void 基于 VSCode 代码库构建构建链路和 VSCode 完全一致Node 依赖、Electron 主进程、浏览器渲染进程三块都要编译。验证环境与依赖是否就绪先核对三件事Node 版本必须是20.18.2仓库.nvmrc里锁定的版本用 nvm 跑nvm install nvm use即可不影响全局版本macOS 需要 Python 和 XCodeWindows 需要 Visual Studio 2022 的 C 桌面开发与 Node.js 构建工具工作负载Linux 需要build-essential、g、libx11-dev等系统包仓库路径里不能有空格准备工作细节都写在 HOW_TO_CONTRIBUTE.md 里逐平台给了命令。打开开发者窗口验证环境真的能跑git clone https://gitcode.com/GitHub_Trending/void2/void cd void npm install安装完依赖后在编辑器里按CtrlShiftBMac 为CmdShiftB触发构建等三个 spinner 中两个变绿然后启动开发者窗口./scripts/code.sh窗口能正常打开、左侧资源管理器能列文件说明环境就绪。之后任何源码改动都要在窗口内按CtrlR重载才生效构建终端里按CtrlD可以干净地停掉 watch 任务。给Void接上你的AI模型云端Key与本地Ollama两条路在设置面板选择供应商与模型Void 把「消息直接发给提供商、不经过中转、不保留你的数据」作为设计原则。设置面板里内置了 16 个供应商分两类云端 APIAnthropic、OpenAI、DeepSeek、OpenRouter、Gemini、Groq、xAI、Mistral以及 Vertex、Azure、Bedrock 等企业端点本地模型Ollama、vLLM、LiteLLM、LM Studio外加一个兜底的 OpenAI 兼容接口可以指向 llama.cpp 等任意兼容服务本地派有个便利机制Ollama 的模型列表是自动探测的你本地ollama pull了新模型设置面板会自动刷出来不用手动登记。看懂模型能力是如何声明的每个模型的上下文窗口、是否支持工具调用specialToolFormat分 openai / anthropic / gemini 三种风格、推理思考标签的解析方式都集中在 modelCapabilities.ts 声明。想用一个新发布的模型而它还没被收录时这个文件就是唯一要查的地方——仓库的官方指南明确提示新模型出现时这里必须更新。让AI真正动手改代码Apply、CmdK与Agent三种工作方式理解Fast Apply为什么能秒改千行文件很多人卡在这一步AI 说我来改然后整个文件被重写一遍diff 没法看。Void 把它拆成两种 ApplyFast Apply让 LLM 输出ORIGINAL / / UPDATED的搜索替换块本质上是让模型帮你按 CtrlH千行文件也能快速命中Slow Apply整文件重写作为兜底点 Apply、LLM 调用 Edit 工具、提交 CmdK 快捷编辑底层跑的是同一套editCodeService代码只是 DiffZone红绿 diff 区域的覆盖范围不同Apply 罩住全文件CmdK 只罩住你选中的小块。改动的逐行审阅、checkpoint 回滚由voidSCMService负责所以 AI 改坏的每一处你都能可视化地看到。用Agent模式跑多步任务聊天有三种模式normal普通问答、gather先收集上下文再回答、agent自主调用工具多步执行。agent 模式下模型通过 tools 机制调用终端命令、编辑文件、查目录结构配合前面的 Apply 机制完成一长串改动作。通过MCP把外部工具交给AI调用 Void 的mcpService实现了 MCPModel Context Protocol客户端你在配置里声明 MCP 服务器Void 就会把服务器暴露的MCPTool列表合并进 agent 模式的工具集。这意味着数据库查询、内部 API、自定义脚手架都可以让模型在对话里直接调用而不是只读你的代码文件。类型定义在common/mcpServiceTypes.ts里字段结构和标准 MCP 协议对齐接第三方服务器不用改代码。从contrib/void目录读懂AI功能源码按三层目录定位你想看的代码Void 的全部 AI 功能源码只有一个家src/vs/workbench/contrib/void/按 VSCode 的双进程模型分三层browser/聊天线程、自动补全、补全提示、侧边栏面板等 UI 层服务common/设置服务voidSettingsService、消息管道sendLLMMessageService、提示词模板prompt/prompts.ts、MCP 与模型能力electron-main/真正的 LLM 请求在这里发出——从主进程发消息既绕开本地供应商的 CSP 限制又能用 node_modules读源码的正确入口是 VOID_CODEBASE_GUIDE.md官方写得很直接仓库没看起来那么吓人服务注册、Action 命令、LLM 消息管道都有图示说明。现在就能做的最小一步打开src/vs/workbench/contrib/void/common/modelCapabilities.ts找到你正在用的那个供应商的模型列表确认你的模型名在不在里面——在直接开聊不在这个文件就是你接入新模型的第一站。【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考