企业官网建设流程全解析

Void开源AI代码编辑器快速上手：4条命令跑通本地构建与AI配置避坑指南

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

还在为AI代码补全付订阅费？Void是基于VSCode代码库改造的开源AI代码编辑器，内置AI对话、行内补全与一键应用代码变更。本文带你从克隆仓库到本地跑通 Void 只用4条命令，并讲清AI密钥在哪配。

核心价值：一个能跑本地模型的VSCode

Void 本质是 VSCode 的深度分叉，AI 能力直接内置在工作区里，而非外挂插件。它内置对 Anthropic、OpenAI、Gemini、Groq 等云端模型的 SDK，也支持 Ollama、LM Studio 这类本地推理服务。适合两类人：想要 Cursor 替代品但要求代码开源、数据可控的开发者；以及想给自家代码编辑器接 AI 的二次开发者。

关键能力速览

最短路径跑通：4条命令

先装好 Node 20.18.2（仓库.nvmrc锁定的版本），Linux 还需 C++ 编译工具链，然后执行：

git clone https://gitcode.com/GitHub_Trending/void2/void cd void && npm install # 安装依赖，版本不对会直接报错 npm run watch # 启动编译，等到出现 Finished compilation ./scripts/code.sh # 启动 Void，Windows 用 scripts/code.bat

窗口打开后按 Ctrl+R 重新加载，即可进入 AI 功能完整的 Void 开发模式。整个流程首次编译大约5分钟。

AI密钥在哪配：设置面板里，不是源码里

Void 的 AI 配置由voidSettingsService统一管理，全部在编辑器内的 Void 设置面板完成：选一个 provider，填apiKey（云端模型）或endpoint（本地 Ollama、LM Studio 等）。设置面板的源码在 src/vs/workbench/contrib/void/，想改默认模型列表就看common/下的配置类型定义，但日常使用完全不需要动源码。

另一个影响体验的开关是 Fast Apply：默认开启，模型只输出需要改动的 Search/Replace 块而不是重写整文件，所以 Apply 到长文件时又快又稳。

实战场景

重构大文件：选中一段几百行的旧代码，在侧边栏让模型改造，点 Apply 后红绿 diff 逐行流式显示，确认无误才落盘。变更走的是编辑器的文本模型，Cmd+Z 随时能撤销，等于给 AI 套了个后悔药。

隐私敏感的代码：把 provider 切到 Ollama，endpoint 指向本机服务，代码全程不出机器，适合处理不敢上传云端的业务逻辑。

浏览代码时也可以利用内置的引用搜索：Alt+Shift+F12把所有引用列成侧边栏视图，F4在结果间跳转，比逐个跳转直观得多。

踩坑速查

症状：npm install卡在 node-gyp 报 gyp ERR!原因：缺 C++ 编译工具。Linux 执行sudo apt-get install build-essential g++ python3；Windows 需在 Visual Studio 2022 里勾选"使用 C++ 的桌面开发"和"Node.js 构建工具"两个工作负载。

症状：启动时报 SUID sandbox helper binary 相关错误（Linux）原因：Electron 沙箱二进制权限不足。执行sudo chown root:root .build/electron/chrome-sandbox && sudo chmod 4755 .build/electron/chrome-sandbox后重新./scripts/code.sh即可。

症状：React 界面构建失败或内存溢出原因：默认堆内存不够。执行NODE_OPTIONS="--max-old-space-size=8192" npm run buildreact用 8GB 堆重建。

延伸探索

• VOID_CODEBASE_GUIDE.md：AI 消息管道、Fast/Slow Apply 内部机制的官方讲解
• HOW_TO_CONTRIBUTE.md：完整开发模式流程、各系统前置依赖与更多常见报错修复
• extensions/：80+ 内置扩展源码，研究编辑器扩展机制的现成教材

编辑器开源了，模型也是你自己挑的——密钥一插，这台机器上的每一行代码都归你管。

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