从零跑通 VoidAI 代码编辑器本地环境搭建与补全配置完整指南【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void跟着本文操作一遍你手里会多出一个本地编译好的 Void——这款开源 AI 代码编辑器的启动窗口——并且完成模型厂商与密钥配置让 AI 代码补全在你自己的项目里真正跑起来。全程只用到三条核心命令新手也能一次过。动手前一张自查表开工前花三十秒对一下这张表缺哪项补哪项能省掉后面八成的排查时间。检查项要求验证命令操作系统Windows 10/1164 位、macOS 10.15、LinuxUbuntu 18.04/Fedora 32—内存≥4GB推荐 8GB 以上—磁盘空间约 10GB依赖 编译产物df -h .Node.js20.18.2仓库根目录 .nvmrc 指定不要用低版本node -vnpm / Gitnpm 7、Git 2.20npm -v/git --version编译工具链Linux/macOS 需 Python3 C 编译器node-gyp 依赖—最容易翻车的一项Node 版本。建议直接用 nvm 按.nvmrc切到 20.18.2nvm install nvm use避免全局版本干扰。三步跑通克隆、装依赖、编译第一步克隆仓库打开终端执行git clone https://gitcode.com/GitHub_Trending/void2/void cd void预期结果本地出现void目录里面能直接看到 src/、extensions/、scripts/ 等目录。第二步安装依赖npm install预期结果node_modules目录生成终端滚过大量包名后安静收尾。这一步会同时编译 Electron 和部分原生模块比平时慢耐心等。装到一半报node-gyp错误先装好 Python3 和 C 工具链再重试Linux 执行sudo apt-get install python3 build-essential gmacOS 执行xcode-select --installWindows 则安装 Visual Studio Build Tools。第三步编译npm run compile预期结果5-10 分钟后视硬件而定out/目录里出现编译好的 JavaScript 产物编译任务以成功状态结束。如果编译中途 OOM 或卡死关掉其他吃内存的应用重跑重复失败时删除node_modules后回到第二步重来。首次运行体验编译完成不代表结束现在才轮到第一次启动。启动编辑器。在仓库根目录执行启动脚本macOS/Linux 用shWindows 用bat./scripts/code.sh # Windows 下为 scripts\code.bat几秒后弹出 Void 的欢迎窗口。左侧是资源管理器上方是命令面板入口欢迎页会引导你完成初始设置——这就是你本地编译出的 AI 代码编辑器界面如下顺手换个主题。按CtrlShiftPmacOS 为CmdShiftP打开命令面板输入Color Theme在弹出的列表里方向键预览、回车确认。第一次接触这个项目的人建议先停在Default Dark或Default Light上。配置 AI 密钥。这是新手和原文资料最大的误区密钥不填在源码里改.ts文件是错误做法。Void 内置了引导流程onboarding支持 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter、Groq 等在线厂商也支持 Ollama、LM Studio 这类本地推理。操作路径按CtrlShiftP输入Void Settings打开设置面板在模型供应商列表里选一个厂商或跟着首次启动的引导页走在对应的API Key输入框粘贴你的密钥保存。保存后回到编辑器打开一个代码文件敲几行补全和对话功能就该有了反应。密钥相关的配置逻辑可以参考 src/vs/workbench/contrib/void/ 目录下的设置类型定义。踩坑速查表症状可能原因解法只留一条npm install报 node-gyp 编译失败缺 Python3 / C 工具链Linuxsudo apt-get install python3 build-essential gmacOSxcode-select --install依赖装完但node -v不是 20.18.2Node 版本不符合 .nvmrcnvm install nvm use后重新npm install启动白屏、闪退用户缓存损坏清除缓存目录Linux/macOS 执行rm -rf ~/.config/void/CacheWindows 执行rd /s /q %APPDATA%\void\Cache再启动AI 功能无响应密钥未保存 / 网络不通 / 厂商限流在设置里重填密钥并保存仍不行则打开帮助菜单里的日志面板确认报错再看网络编译中途内存爆掉8GB 内存机器并行任务太多关闭浏览器等应用重跑npm run compile往深处走想理解代码结构读根目录的 VOID_CODEBASE_GUIDE.mdVoid 的核心功能代码集中在src/vs/workbench/contrib/void/想看扩展怎么写的翻 extensions/ 下的内置扩展如references-view的引用视图想参与开发或提问题HOW_TO_CONTRIBUTE.md 里有完整流程问题可以直接去项目的 issues 页面反馈。本地环境和 AI 补全都通了剩下就是去社区或 issues 里继续问、继续折腾——编译链一旦跑通后面改什么都快了。【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从零跑通 Void：AI 代码编辑器本地环境搭建与补全配置完整指南
从零跑通 VoidAI 代码编辑器本地环境搭建与补全配置完整指南【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void跟着本文操作一遍你手里会多出一个本地编译好的 Void——这款开源 AI 代码编辑器的启动窗口——并且完成模型厂商与密钥配置让 AI 代码补全在你自己的项目里真正跑起来。全程只用到三条核心命令新手也能一次过。动手前一张自查表开工前花三十秒对一下这张表缺哪项补哪项能省掉后面八成的排查时间。检查项要求验证命令操作系统Windows 10/1164 位、macOS 10.15、LinuxUbuntu 18.04/Fedora 32—内存≥4GB推荐 8GB 以上—磁盘空间约 10GB依赖 编译产物df -h .Node.js20.18.2仓库根目录 .nvmrc 指定不要用低版本node -vnpm / Gitnpm 7、Git 2.20npm -v/git --version编译工具链Linux/macOS 需 Python3 C 编译器node-gyp 依赖—最容易翻车的一项Node 版本。建议直接用 nvm 按.nvmrc切到 20.18.2nvm install nvm use避免全局版本干扰。三步跑通克隆、装依赖、编译第一步克隆仓库打开终端执行git clone https://gitcode.com/GitHub_Trending/void2/void cd void预期结果本地出现void目录里面能直接看到 src/、extensions/、scripts/ 等目录。第二步安装依赖npm install预期结果node_modules目录生成终端滚过大量包名后安静收尾。这一步会同时编译 Electron 和部分原生模块比平时慢耐心等。装到一半报node-gyp错误先装好 Python3 和 C 工具链再重试Linux 执行sudo apt-get install python3 build-essential gmacOS 执行xcode-select --installWindows 则安装 Visual Studio Build Tools。第三步编译npm run compile预期结果5-10 分钟后视硬件而定out/目录里出现编译好的 JavaScript 产物编译任务以成功状态结束。如果编译中途 OOM 或卡死关掉其他吃内存的应用重跑重复失败时删除node_modules后回到第二步重来。首次运行体验编译完成不代表结束现在才轮到第一次启动。启动编辑器。在仓库根目录执行启动脚本macOS/Linux 用shWindows 用bat./scripts/code.sh # Windows 下为 scripts\code.bat几秒后弹出 Void 的欢迎窗口。左侧是资源管理器上方是命令面板入口欢迎页会引导你完成初始设置——这就是你本地编译出的 AI 代码编辑器界面如下顺手换个主题。按CtrlShiftPmacOS 为CmdShiftP打开命令面板输入Color Theme在弹出的列表里方向键预览、回车确认。第一次接触这个项目的人建议先停在Default Dark或Default Light上。配置 AI 密钥。这是新手和原文资料最大的误区密钥不填在源码里改.ts文件是错误做法。Void 内置了引导流程onboarding支持 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter、Groq 等在线厂商也支持 Ollama、LM Studio 这类本地推理。操作路径按CtrlShiftP输入Void Settings打开设置面板在模型供应商列表里选一个厂商或跟着首次启动的引导页走在对应的API Key输入框粘贴你的密钥保存。保存后回到编辑器打开一个代码文件敲几行补全和对话功能就该有了反应。密钥相关的配置逻辑可以参考 src/vs/workbench/contrib/void/ 目录下的设置类型定义。踩坑速查表症状可能原因解法只留一条npm install报 node-gyp 编译失败缺 Python3 / C 工具链Linuxsudo apt-get install python3 build-essential gmacOSxcode-select --install依赖装完但node -v不是 20.18.2Node 版本不符合 .nvmrcnvm install nvm use后重新npm install启动白屏、闪退用户缓存损坏清除缓存目录Linux/macOS 执行rm -rf ~/.config/void/CacheWindows 执行rd /s /q %APPDATA%\void\Cache再启动AI 功能无响应密钥未保存 / 网络不通 / 厂商限流在设置里重填密钥并保存仍不行则打开帮助菜单里的日志面板确认报错再看网络编译中途内存爆掉8GB 内存机器并行任务太多关闭浏览器等应用重跑npm run compile往深处走想理解代码结构读根目录的 VOID_CODEBASE_GUIDE.mdVoid 的核心功能代码集中在src/vs/workbench/contrib/void/想看扩展怎么写的翻 extensions/ 下的内置扩展如references-view的引用视图想参与开发或提问题HOW_TO_CONTRIBUTE.md 里有完整流程问题可以直接去项目的 issues 页面反馈。本地环境和 AI 补全都通了剩下就是去社区或 issues 里继续问、继续折腾——编译链一旦跑通后面改什么都快了。【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考