ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;display: table;padding: 0.5em 1em;color: rgb(63, 63, 63);text-shadow: rgba(0, 0, 0, 0.1) 2px 2px 4px;">项目介绍

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">你是否在使用 GitHub Copilot 或 Cursor 的时候，觉得它们的智能补全虽然强大，但总有些地方不尽如人意？比如，价格高昂，或者一些功能限制让人抓狂？今天介绍一款新工具——Void，这款编辑器号称是开源的 Cursor 和 GitHub Copilot 替代品，而且完全免费！

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">在你的代码库中使用 AI 代理，检查点并可视化更改，并将任何模型或主机本地化。Void 直接向提供者发送消息，而不会保留你的数据。拥有与 Cursor 几乎一样强大的编程功能，最大的不同 Void 是可直接连接任何 AI 模型或使用本地部署模型，无需再经过第三方服务器。

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">基于 VS Code 开发，可一键导入原有主题、快捷键和设置，对于已习惯 VS Code 编辑器的开发者来说颇为友好。

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;margin: 0.1em auto 0.5em;border-radius: 8px;box-shadow: rgba(0, 0, 0, 0.1) 0px 4px 8px;height: auto !important;" title="null" src="https://api.ibos.cn/v4/weapparticle/accesswximg?aid=110924&url=aHR0cHM6Ly9tbWJpei5xcGljLmNuL3N6X21tYml6X3BuZy9CT0FqdjcxMUVGaEM5RzRJRTdpYWVCeFVETHBtSXNQZlZ2ZzRCUks1UGJMN2liSDFvaDA0MDlxZ2ljYVBmaDBmUzhqRkVxNldPenhBd01PUXQ4YWd4cXhLQS82NDA/d3hfZm10PXBuZyZhbXA=;from=appmsg"/>

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;display: table;padding: 0.3em 1em;color: rgb(255, 255, 255);background: rgb(0, 152, 116);border-radius: 8px;box-shadow: rgba(0, 0, 0, 0.1) 0px 4px 6px;">主要功能

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;text-indent: -1em;display: block;margin: 0.5em 8px;color: rgb(63, 63, 63);">
• 按 Tab 键智能补全代码，支持内联编辑（Ctrl+K），操作体验超流畅；
ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;text-indent: -1em;display: block;margin: 0.5em 8px;color: rgb(63, 63, 63);">
• 强大的 Agent 模式可搜索、创建、编辑文件，甚至有终端访问权限；
• 独特的 Gather 模式提供只读搜索功能，更安全地分析代码库；
• Checkpoints 功能可视化 AI 代码修改，轻松追踪和比较所有变更；
• 即使不支持工具调用的开源模型，也能在 Agent 模式下使用；
• 智能代码错误检测，AI 能主动发现并修复代码问题；
• 超快速应用功能，即使对 1000 行大文件也能即时生效。

如何上手 Void？

说了这么多，可能你已经有点心动了。那该如何开始使用 Void 呢？其实步骤非常简单。

• 首先，访问 Void 的官网，下载适用于你系统的安装包,没有加白的先申请白名单。
• 安装完成后，按照文档配置好开发环境。如果你是 VSCode 用户，Void 可以无缝集成，使用起来几乎没有学习成本。
• 开启编辑器，开始写代码吧！在你键入几行代码后，Void 会自动为你提供补全建议，你可以根据需求接受或者忽略它的建议。

如何构建

Mac - 构建前提

需安装 Python 和 XCode（通常已默认安装）。

Windows - 构建前提

1. 安装Visual Studio 2022（推荐）或VS Build Tools。
2. 在“工作负载”选项卡中勾选：

•Desktop development with C++
•Node.js build tools

3. 在“单个组件”选项卡中勾选：

•MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
•C++ ATL for latest build tools with Spectre Mitigations
•C++ MFC for latest build tools with Spectre Mitigations

4. 点击安装。

Linux - 构建前提

1. 运行npm install -g node-gyp。
2. 根据系统选择以下命令：

• Debian/Ubuntu：sudo apt-get install build-essential g++ libx11-dev libxkbfile-dev libsecret-1-dev libkrb5-dev python-is-python3。
• Fedora：sudo dnf install @development-tools gcc gcc-c++ make libsecret-devel krb5-devel libX11-devel libxkbfile-devel。
• 其他系统：参考VSCode 贡献指南。

在 VSCode 中构建 Void

1.git clone https://github.com/voideditor/void
2.npm install
3. 在 VSCode 中按：

• Windows/Linux：Ctrl+Shift+B
• Mac：Cmd+Shift+B
• 构建约需 5 分钟，完成后会显示两个勾选标记。

4. 运行 Void：

• Windows：./scripts/code.bat
• Mac/Linux：./scripts/code.sh

小技巧：

• 按Ctrl+R（Mac 为Cmd+R）快速重载窗口。
• 添加--user-data-dir ./.tmp/user-data --extensions-dir ./.tmp/extensions参数可重置测试环境（删除.tmp文件夹即可）。

终端构建

运行npm run watch，完成时会显示类似以下信息：

[watch-extensions] Finished compilation extensions with 0 errors after 19303 ms 
[watch-client] Finished compilation with 0 errors after 46248 ms

常见问题

• 确保 Node 版本为20.18.2（使用nvm install和nvm use切换）。
• 路径中不要包含空格。
• 若出现TypeError: Failed to fetch dynamically imported module，检查导入语句是否以.js结尾。
• React 错误尝试运行NODE_OPTIONS="--max-old-space-size=8192" npm run buildreact。

打包

通常不建议打包，直接构建即可。若需生成可执行文件，运行以下命令（约需 25 分钟）：

Mac：

• Apple Silicon：npm run gulp vscode-darwin-arm64
• Intel：npm run gulp vscode-darwin-x64

Windows：

• 主流：npm run gulp vscode-win32-x64

Linux：

• 主流：npm run gulp vscode-linux-x64

输出路径：

workspace/ 
├── void/     # 你的 Void 仓库 
└── VSCode-darwin-arm64/ # 生成的打包文件

链载Ai