4 步本地跑通 Void：开源 AI 代码编辑器完整搭建与配置指南
【免费下载链接】void开源AI代码编辑器，Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void
Void 是一款开源的 AI 代码编辑器，智能补全、AI 侧边栏一应俱全，常被当作 Cursor 的替代方案。本文带你完成一次完整的 Void 环境搭建：拉代码、装依赖、编译、启动四步跑通本地部署，再配好 AI 密钥与主题，新手也能一次搞定这款 AI 编辑器的开发环境。
📋 开始前，确认这 3 件事
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10/11（64位）、macOS 10.15+ 或主流 Linux 发行版 |
| 硬件 | 4GB 内存起步（建议 8GB+），预留 5GB 磁盘 |
| 工具 | Node.js20.18.2（仓库.nvmrc锁死此版本）、npm、Git |
Node 版本不匹配是装依赖时最容易翻车的点，建议直接用 nvm 切：
nvm use # 读取 .nvmrc 自动切到 20.18.2🔧 搭建主线：4 个动作跑通 Void
1. 克隆仓库
git clone https://gitcode.com/GitHub_Trending/void2/void && cd void看到目录下有src/、extensions/、package.json，就说明拉取成功。
2. 安装依赖
npm install⚠️ 报node-gyp/gyp错误，基本是缺编译工具链：Linux 装python3 build-essential，Windows 装 Visual Studio 2022 的 "C++ 桌面开发 + Node.js 构建工具" 组件，macOS 跑xcode-select --install即可。
⚠️ 如果报错里出现 Electron 版本相关提示，先回上面把 Node 切到 20.18.2 再来一次，别急着删 lock 文件。
3. 启动构建
npm run watch首次编译约 5 分钟，看到Finished compilation with 0 errors这样的日志、三个进度环变成对勾，构建就完成了。这个命令会持续监听源码，改代码后自动增量编译，不用反复执行。
4. 首次启动
./scripts/code.sh # macOS / Linux ./scripts/code.bat # Windows窗口弹出、看到欢迎页，你的 Void 本地版本就跑起来了：
⚠️ 项目路径里带空格会导致启动异常，仓库放一个无空格的目录，比如~/code/void。
⚡ 跑起来之后，两件必配的事
最快配好 AI 密钥
AI 功能靠各家模型的 API Key 驱动，配错或漏配，侧边栏里的补全和对话就全是摆设。
- 改哪里：启动后首次会自动进入 AI 引导页（源码在 void-onboarding/VoidOnboarding.tsx），也可以在侧边栏打开对应 Provider 的设置卡片，不用改源码。
- 填什么：按你选的 Provider（Claude、Gemini、OpenRouter、Ollama 等）填入 apiKey，注意长度要过校验（15 字符以上），本地 Ollama 则不用密钥、装好服务自动识别。
- 怎么确认生效：在编辑器里按
Cmd+L（Linux/Win 为Ctrl+L）对一段代码提问，能收到正常回复就算通了。
选一个顺眼的主题
- 改哪里：命令面板（
Ctrl+Shift+P）搜索Color Theme。 - 填什么：新手推荐
Default Dark+或Default Light+，extensions/下的 theme-* 系列还有 Abyss、Solarized 等可选。 - 怎么确认生效：切换即时生效，界面配色当场变化；不满意随时再切，不影响任何配置。
🔍 现象 → 动作：排错速查
| 现象 | 一条命令 / 一个动作 |
|---|---|
| 装依赖时 node-gyp 编译报错 | Linux：sudo apt-get install build-essential python3；Windows 补装 VS Build Tools 组件 |
| 启动报 Node / Electron 版本不匹配 | nvm use切回 20.18.2 后重新npm install |
| 启动白屏或窗口崩溃 | 清缓存rm -rf ~/.config/void/Cache（Windows 为%APPDATA%\void\Cache）后重启 |
| Linux 报 SUID sandbox 配置错误 | sudo chown root:root .build/electron/chrome-sandbox && sudo chmod 4755 .build/electron/chrome-sandbox |
🧭 想再深入，从这里进
- HOW_TO_CONTRIBUTE.md：官方贡献流程，含各平台前置依赖和开发者模式用法，改代码前必读。
- VOID_CODEBASE_GUIDE.md：讲清 VSCode 架构、Void 的 LLM 消息管线，帮你看懂源码组织。
- extensions/：内置扩展示例，想给 Void 写插件可以直接照抄结构。
到这里，一个能写代码、能调 AI 的 Void 开发环境就齐了。编译或行为上的怪问题，优先翻仓库 issues，也可以去社区 Discord 问一句，通常比你自己在终端里猜要快。
【免费下载链接】void开源AI代码编辑器，Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
