Ollama 已下载模型，却无法在编辑器里调用，或运行时 Mac 变慢？
最快做法：搭建本地 AI 编程环境时，先核对 macOS、可用存储和设备资源，再安装 Ollama、运行兼容的本地模型，最后用 VS Code 扩展连接并验证代码生成。是否适合日常开发，要以你自己的小规模测试为准。
这篇文章适合想在 Mac 上运行本地模型辅助写代码的开发者。
如果你准备把 Ollama 接入 VS Code，或拿不准本机资源是否匹配模型，可以按下方顺序逐项检查。
Mac 本地 AI 编程环境：安装前先核对什么
本地推理与在线 AI 服务不是一回事：本地模型由你这台 Mac 运行，模型文件占用本机存储，推理也会使用设备资源；在线服务则把请求发送到远端服务。若你的目标是断网时仍能调用模型，应先确认模型和依赖已下载，并检查编辑器扩展自身是否依赖网络。使用本地模型也不等于整个扩展链路天然离线或完全私密。
先查看「系统设置」中的 macOS 版本、存储空间和「关于本机」里的芯片与内存信息。Ollama 的 macOS 下载说明列出 macOS 14 Sonoma 或更新版本的要求；若你的系统较旧，先确认能否升级，不要把安装失败误判成模型问题。
资源检查不只看模型文件大小。运行时还要给 macOS、VS Code、项目工具链和模型上下文留出空间；模型尺寸越大，资源压力通常也越值得优先评估。模型目录可用空间不足、开发工具同时运行，或上下文设置偏大，都可能导致下载失败、加载报错或交互迟缓。不要仅凭芯片名称推断“肯定跑得动”。
本地方案更适合你想在自己的设备上完成推理、愿意自行管理模型，并能接受按设备能力选择模型的情况。若你需要更强的模型能力、希望多个开发者共享同一推理环境，或不想让个人电脑承担持续负载，就应先评估其它方案，而不是假设所有 Mac 都能流畅运行所有模型。
Ollama 安装与本地模型选择
安装 Ollama 并确认服务可用
适用系统：满足官方页面要求的 macOS。所需工具：浏览器、终端。验证结果：命令行可识别 Ollama，且本机服务有响应。
从 Ollama 官方 macOS 下载页获取安装程序，按安装界面提示完成安装并启动应用。随后打开「终端」，执行：
ollama --version
ollama list
第一条命令用于确认命令行工具可用，第二条用于查看当前已安装模型。若提示找不到命令，先确认应用已安装、启动，并检查终端是否能找到 Ollama 命令；不要立刻重复下载模型。
Ollama 默认本地服务地址为 http://localhost:11434。可以在浏览器打开该地址，或执行：
curl http://localhost:11434
看到服务运行提示，才说明服务端已响应。Ollama 的 官方常见问题说明记录了 macOS 应用与本地服务的管理方式；若应用已启动，不要再盲目另开一个 ollama serve，以免遇到端口已被占用的情况。
按用途和设备资源选模型
首次验证优先选较小模型，先确认完整链路，再判断是否值得换更大的模型。以代码任务为例，Ollama 模型库的 Qwen2.5-Coder 标签页列出 qwen2.5-coder:1.5b 文件约 986 MB、qwen2.5-coder:7b 文件约 4.7 GB，两者页面均标有 32K 上下文窗口。文件大小是下载模型文件的占用参考，不等于运行时所需内存，也不能单独用来预测生成速度。
| 选择思路 | 示例模型 | 适合的验证任务 | 需要注意 |
|---|---|---|---|
| 先验证链路、减轻下载负担 | qwen2.5-coder:1.5b |
解释短函数、补充简单测试 | 回答质量和复杂任务能力需由你的项目实测 |
| 评估更大模型的开发体验 | qwen2.5-coder:7b |
对比代码修改建议、处理较长问题 | 文件更大，运行资源压力也应重新评估 |
| 需要其它模型能力 | 按 Ollama 模型库选择 | 根据语言、任务及功能需求测试 | 核对精确模型标签、模型功能与设备适配 |
拉取并启动示例模型：
ollama pull qwen2.5-coder:1.5b
ollama run qwen2.5-coder:1.5b
首次拉取需要等待模型下载。进入交互后输入一段简单的代码问题，能收到回答即表示模型可运行；输入 /bye 退出。切换到其它模型时，用 ollama list 确认本机实际标签，并确保后续编辑器配置使用同一个标签。模型页面提供的标签和说明可帮助你确认下载对象；模型是否适合你的开发任务仍需用实际代码验证。
VS Code 连接配置与权限
用 Continue 连接 Ollama
这里以 Continue 作为接入示例，不代表所有 VS Code 扩展都使用同一套设置。先按 Continue 安装说明从扩展市场安装 Continue，再打开其侧边栏，按界面指引进入本地配置。Continue 当前文档使用 YAML 配置；Mac 上的配置文件位置为 ~/.continue/config.yaml。
将下面配置中的模型名换成 ollama list 显示的实际标签：
name: Local Ollama
version: 1.0.0
schema: v1
models:
- name: Qwen Coder Local
provider: ollama
model: qwen2.5-coder:1.5b
apiBase: http://localhost:11434
roles:
- chat
- edit
- apply
这里的 provider、model 和 apiBase 都有实际作用：前者指定 Ollama，模型标签必须与本机已下载的名称一致，服务地址则指向当前 Mac 的本地端口。Continue 的 Ollama 提供方配置文档列出了相应配置字段；该扩展的 Ollama 使用指南也说明了模型未拉取时会发生什么，以及如何通过自动发现或手动配置选择模型。
保存配置后，在 Continue 的模型选择器中选中本地模型；若列表未刷新，使用扩展提供的配置重载操作，再确认模型选择器显示的是预期标签。先用聊天或代码解释功能，不要一开始就启用自动修改、终端执行等更高权限的代理能力。不同扩展的模型角色、端口和设置入口可能不同，应按各自文档配置，不能照搬上述 YAML。
还要检查 VS Code 的安全边界。陌生仓库可能处于受限模式，导致扩展或代理功能不可用；只有确认项目来源可信后再信任工作区。VS Code 工作区信任说明指出，受限模式会限制部分扩展和可执行功能；扩展也可能拥有读取或修改本机文件、发起网络请求等权限，安装前应核对发布者和扩展权限说明。
代码生成验证与故障排查
低风险验证流程
先在一个临时文件或新建测试项目中请求解释一段不含密钥、个人数据或生产代码的短函数。要求模型说明输入、输出和一个边界情况，再让它生成对应的单元测试。你可以手动检查代码是否符合项目语言和测试框架；在确认建议正确之前，不要直接应用到生产文件。
按顺序检查这条调用链：
- Ollama 是否响应：访问
http://localhost:11434，确认本地服务有回应。 - 模型是否可见：运行
ollama list，核对模型标签；如尚未下载，先执行对应的ollama pull。 - 扩展是否指向正确地址：确认 Continue 配置中的
apiBase为本机地址，且model与本机标签逐字一致。 - 工作区是否受限：在确认仓库可信后检查 VS Code 的工作区信任状态；陌生项目不要为启用 AI 功能而直接放开权限。
- 资源是否成为瓶颈：先关闭不必要的应用，缩短测试输入或改用较小模型，再比较是否能稳定完成同一任务。
若扩展提示连接失败，优先分别测试本地服务和扩展配置。先确认 Ollama 服务正在运行，再依照前文的 Ollama 提供方配置文档核对模型名称与连接地址；若模型能在终端运行、但扩展提示需要更多系统内存，可检查上下文长度或改用更小模型。
按表现定位问题
- 终端也无法运行模型：优先检查 Ollama 服务、模型下载和设备资源；这时调整 VS Code 配置通常解决不了根因。
- 终端能运行，扩展不能连接：先核对
apiBase、模型标签和扩展配置是否重载，再检查工作区限制。 - 能连接但生成迟缓或中断：比较较小模型与较短上下文的表现，同时观察 Mac 是否还在承担编译、浏览器和模拟器等任务。不要把一次成功请求当成持续负载测试结果。
- 聊天可用，但编辑或代理功能不可用：检查该模型是否支持对应能力，以及扩展是否为该模型启用了相应角色。能聊天不代表自动修改、工具调用等功能也兼容。
本机验证清单与下一步选择
在开始把模型用于日常项目之前，逐项完成下面的检查：
- [ ] macOS 满足 Ollama 当前官方安装要求，Ollama 命令可用。
- [ ] 模型下载完成，
ollama list显示的标签与 VS Code 配置一致。 - [ ] 本地服务地址可访问，终端交互能收到模型回答。
- [ ] VS Code 扩展已选择正确模型，聊天或代码解释测试通过。
- [ ] 测试仓库可信，未在未确认来源的项目中放开受限模式。
- [ ] 用实际项目的短任务复测，确认资源占用和响应情况能接受。
如果前三项通过而 VS Code 失败，先处理编辑器连接与权限；如果终端运行本身就不稳定，再调整模型大小、输入长度和并行负载。只有通过你自己的代码任务验证，才适合把它纳入日常开发。需要了解 Mac 资源与本地模型选择时，可参考本站的 Mac mini 配置与价格信息；具体配置和价格以页面当前展示为准。
本机方案的优势是代码编辑与推理都在手边，但资源受设备限制、模型文件占用本地存储，而且持续推理会与 IDE 和其它开发任务争用资源。自购 Mac 能避免远程操作，但要承担一次性购置和后续维护；远程 Mac 可把开发负载移出个人电脑，却会增加网络延迟、文件传输和远程管理环节，也不等同于本机推理体验。
先按本文流程完成本机验证；如果确认资源或远程开发环境不适合你的项目，再查看本站当前的 Mac 配置与交付信息，核对实际方案与交付方式后，判断是否值得把开发任务迁到远程 Mac。