之前的文章介绍了Void 编辑器, 又介绍了基于 Ollama 的 Qwen3-4B-2507 模型部署,这个模型特别轻量级,甚至可以在千元红米手机上流畅运行Qwen3-4B-2507
实测Void+Ollama+Qwen3-4B-2507 构建本地离线AI辅助开发环境,在4060 8G显卡的笔记本上可谓飞快了。
本文就是整理出来的一份一站式安装与使用指南,覆盖 Windows 与 Ubuntu 24.04,包含四个部分:Void安装、Ollama安装、模型获取、Void配置,更适合新手朋友。
0 安装前准备
- 硬件与系统
- Windows 10/11 x64,或 Ubuntu 24.04 x86_64
- 内存 ≥ 8 GB(推荐 16 GB),磁盘空余 ≥ 10 GB
- 可选 GPU(NVIDIA 有助于加速,但 Qwen3-4B 在 CPU 上也可用)
- 网络
- 需能访问
ollama.com
拉取模型;网络受限时可先离线安装 Void 与 Ollama,再为模型拉取配置代理 - 组件
- Void 编辑器 GitHub Releases
- Ollama 下载页
- Qwen3-4B 模型(思考版与指令版,后面通过ollama pull获取):
hopephoto/qwen3-4b-thinking-2507_q8
、hopephoto/qwen3-4b-instruct-2507_q8
1 Void 安装
1.1 Windows
- 官方发布页:Void binaries releases
- 示例版本:
- Windows 安装包:VoidSetup-x64-1.99.30044.exe
- 百度网盘镜像:
- Void:下载链接 提取码:
cugb
- 安装步骤
- 双击安装程序,按向导完成。
- 首次启动可暂不配置 AI,待安装好 Ollama 后再接入。
1.2 Ubuntu
- 官方发布页:Void binaries releases
- 示例版本:
- Ubuntu 安装包:void_1.99.30044_amd64.deb
- 安装命令
wget -O void.deb https://github.com/voideditor/binaries/releases/download/1.99.30044/void_1.99.30044_amd64.deb
sudo dpkg -i void.deb || sudo apt -f install -y
# 如有依赖问题:
# sudo apt --fix-broken install -y && sudo dpkg -i void.deb
2 Ollama 安装
2.1 Windows
- 官网下载页:Ollama Download
- Windows 安装包:OllamaSetup.exe
- 百度网盘镜像:
- Ollama:下载链接 提取码:
cugb
- 安装后验证(PowerShell)
ollama --version
# 如提示未识别命令,重开 PowerShell 或重新登录系统再试
2.2 Ubuntu
- 一键安装
curl -fsSL https://ollama.com/install.sh | sh
- 安装后验证(Bash)
ollama --version
3 模型获取
- 拉取 Qwen3-4B 模型(思考版与指令版)
ollama pull hopephoto/qwen3-4b-thinking-2507_q8
ollama pull hopephoto/qwen3-4b-instruct-2507_q8
ollama list
- 注意
- Ollama的默认服务地址为
http://127.0.0.1:11434
。若端口占用,可设置环境变量OLLAMA_HOST=127.0.0.1:PORT
后重启服务。 - 若模型列表为空,先确认网络或镜像源是否可用,再次执行上面的
ollama pull
加上模型名字的过程。
4 Void 配置
1) 启动 Void 并打开设置
- 如果没设置过,会出现下面的欢迎界面。
- 如果已经设置过了就打开 Settings → AI / Providers,也能修改设置。
- 确保前文已安装好 Ollama 并在本机运行。
- 说明:若版本较旧,建议先升级,以获得更好的兼容性。
2) 选择本地 Ollama 作为提供者
- 在 Provider 类型中选择 Local(本地)/ Ollama。
- Base URL 默认就是填写的 http://127.0.0.1:11434
。
- 说明:若端口被占用或自定义,请按实际端口填写。
3) 滚动并查找本地模型
- 在模型列表中滚动,找到 hopephoto/qwen3-4b-thinking-2507_q8
与 hopephoto/qwen3-4b-instruct-2507_q8
。
- 说明:若列表为空,优先在终端执行
ollama list
确认模型已成功拉取。
4) 点击 Next 继续配置
- 保持默认设置,点击 Next(下一步)。
- 说明:如需更改默认参数(例如上下文长度、并发度),可在后续设置中调整。
5) 导入插件,按向导完成
- 可能提示你是否从其他编辑器导入插件,如是则按提示导入,否则可跳过。
- 注意:微软官方的一些插件好像不让开源版本用。
6) 勾选要启用的模型
- 选中 hopephoto/qwen3-4b-thinking-2507_q8
和/或 hopephoto/qwen3-4b-instruct-2507_q8
,确认保存。
- 说明:思考版更擅长复杂推理,指令版更适合日常问答与代码指令执行。
7) 完成接入并开始使用
- 在聊天/补全面板中选择对应模型开始对话或生成代码。
- 说明:若响应异常,优先检查 Ollama 是否在运行,以及
http://127.0.0.1:11434
是否可访问。