Void 安装使用教程

🚀 项目介绍

Void 是一个基于 VSCode 源码开发的开源 AI 编程助手，目标是成为 Cursor 的完美替代品。它保留了 VSCode 的所有功能，同时加入了强大的 AI 编程能力。

✨

核心优势：完全开源、永久免费、支持本地大模型、保留 VSCode 完整生态！

项目信息	详情
GitHub 地址	github.com/voideditor/void
基于	VSCode 源码 Fork
开源协议	MIT License
支持平台	Windows / macOS / Linux

⚡ 核心功能

🧠

自动编程

描述需求，自动生成完整代码模块

📝

智能 Git Commit

分析改动，自动生成规范提交信息

👻

Ghost Text

实时预测代码，Tab 键一键接受

🤖

本地模型

支持 Ollama 等本地模型，数据更安全

💡

Void 完全兼容 VSCode 插件生态，你现有的插件和配置可以无缝迁移！

📋 环境要求

要求	说明
操作系统	Windows 10+、macOS 10.15+、Ubuntu 20.04+
内存	建议 8GB 以上
Node.js	18.x 或更高版本（从源码编译时需要）
API Key	OpenAI / Anthropic / 或本地 Ollama

⚙️ 安装步骤

方式一：下载预编译版本（推荐）

下载安装包

访问 Void 官方 GitHub Releases 页面，下载对应操作系统的安装包：

链接

https://github.com/voideditor/void/releases

Windows: 下载 .exe 安装程序
macOS: 下载 .dmg 镜像文件
Linux: 下载 .deb / .rpm / .AppImage

安装运行

双击安装包，按照提示完成安装即可。安装后会在桌面/应用程序中看到 Void 图标。

方式二：从源码编译

克隆代码仓库

bash

git clone https://github.com/voideditor/void.git
cd void

安装依赖并编译

bash

# 安装依赖
npm install

# 编译项目
npm run build

# 启动开发版
npm run dev

⚠️

注意：从源码编译需要 Node.js 18+ 和较长的编译时间，普通用户建议直接下载预编译版本。

⭐ 强烈推荐

🎁 增强版下载

🖼️

支持图片识别

对话框直接上传图片分析

🔧

修复卡死 Bug

解决首次启动白屏问题

📦

开箱即用

无需额外配置，下载即用

🚀

持续更新

跟进官方版本同步优化

📦 获取增强版安装包

搜索关键词：void安装包下载，支持图片识别

👉 闲鱼获取

🔑 模型配置

Void 支持多种 AI 模型，你可以选择使用在线 API 或本地模型：

在线模型配置

服务商	推荐模型	获取 API Key
OpenAI	GPT-4o / GPT-4o-mini	platform.openai.com
Anthropic	Claude 3.5 Sonnet	console.anthropic.com
DeepSeek	DeepSeek-V4	platform.deepseek.com

在 Void 中配置 API Key：

打开 Void
按 Ctrl + , 打开设置
搜索 "API Key"
填入对应的 API Key

本地模型配置（Ollama）

安装 Ollama

访问 ollama.ai 下载安装 Ollama。

下载模型

bash

# 下载 CodeLlama（代码专用）
ollama pull codellama

# 或下载 DeepSeek Coder
ollama pull deepseek-coder:6.7b

在 Void 中配置

在设置中选择 "Ollama" 作为模型提供商，填入本地地址 http://localhost:11434。

🔒

数据安全：使用本地模型，你的代码数据完全在本地处理，不会上传到任何服务器！

💻 使用方法

1. AI 对话编程

按 Ctrl + L 打开 AI 对话面板，输入需求描述：

示例

帮我写一个 Python 爬虫，抓取豆瓣电影 Top250

2. 代码内编辑

选中代码后按 Ctrl + K，输入修改指令：

示例

添加错误处理和日志记录

3. Ghost Text 补全

正常编写代码时，Void 会自动显示灰色的补全建议，按 Tab 接受。

4. 智能 Git Commit

在 Git 面板中点击 ✨ 按钮，Void 会自动分析改动并生成 Commit Message。

快捷键汇总

快捷键	功能
`Ctrl + L`	打开 AI 对话面板
`Ctrl + K`	代码内编辑（选中代码后）
`Tab`	接受 Ghost Text 补全
`Esc`	取消当前 AI 操作

❓ 常见问题

Q1: Void 和 Cursor 有什么区别？

主要区别：

开源 vs 闭源：Void 完全开源，Cursor 是闭源商业软件
价格：Void 永久免费，Cursor 需要订阅付费
本地模型：Void 原生支持 Ollama 等本地模型
定制性：Void 代码开源，可以自由修改定制

Q2: 原来的 VSCode 插件能用吗？

可以！Void 基于 VSCode 源码开发，完全兼容 VSCode 插件生态。你可以直接安装使用所有 VSCode 插件。

Q3: API 调用会产生费用吗？

这取决于你选择的模型：

本地模型（Ollama）：完全免费，不产生任何费用
在线 API：按实际调用量计费，具体价格参考各服务商

Q4: 支持中文吗？

支持！界面语言继承 VSCode 的语言设置，AI 对话也完全支持中文。

Q5: 如何更新到最新版本？

Void 内置自动更新功能，有新版本时会提示更新。你也可以手动到 GitHub Releases 页面下载最新版本。

Q6: 首次启动时界面卡死/白屏怎么办？

这是 Void 原版的一个已知 Bug。解决方案：

方法一：多等待几分钟，首次加载可能较慢
方法二：下载增强版安装包，该问题已修复 👉 闲鱼获取

Q7: Void 支持图片识别吗？

原版 Void 不支持在对话框中上传图片。如需此功能，可使用增强版安装包，已集成图片识别能力，支持直接上传截图/设计图进行分析。