Ollama macOS 安装与部署

macOS 上是三个平台里装起来最省事的：拖进 Applications 就完事，后台服务自带，Metal 加速开箱可用。麻烦的地方不在安装，而在磁盘空间——模型动辄几十 GB，Mac 的硬盘又不能随便加。

版本基线 v0.40.12，官方 docs.ollama.com/macos。

一、系统要求

Intel Mac 能用，但只有 CPU 推理，速度差距很大。如果你的机器是 Intel 芯片，跑小模型（1B–8B）尚可，大模型基本不现实。

二、安装与 CLI 链接

标准流程是挂载 ollama.dmg，把 Ollama 应用拖进系统级的 Applications 文件夹。

首次启动时，应用会检查 ollama 命令是否在你的 PATH 里。如果没检测到，会弹出请求，征求你同意在 /usr/local/bin 创建链接——点同意即可，之后终端里就能直接用 ollama 命令。

这一步常被忽略，也是「装好了但终端里 ollama: command not found」的最常见原因。如果当时点了拒绝，手动建个软链也行：

## 指向应用包内的 CLI 二进制
sudo ln -sf /Applications/Ollama.app/Contents/Resources/ollama /usr/local/bin/ollama
ollama -v

三、装到非默认位置

想把应用装到别处（比如外置固态硬盘），做法是：把应用放到目标位置，确保 Ollama.app/Contents/Resources/ollama 或它的软链在 PATH 中，然后首次启动时拒绝「Move to Applications?」的请求。

拒绝那一下是必须的，否则系统会把应用搬回 /Applications。

四、模型存哪：先算清磁盘

默认所有数据都在 ~/.ollama 里。三个位置各有分工：

Mac 用户最常撞的墙就是磁盘满。装之前先看一眼可用空间：

df -h ~

一个 7B 模型约 4–5 GB，30B 级动辄 20 GB 起。建议提前把 OLLAMA_MODELS 指到外置盘或大分区，别等下载到一半失败。

设置方式在 macOS 上比较特殊——图形方式运行的应用不读 shell 配置，要用 launchctl：

## 指向外置盘目录（先确保目录存在）
launchctl setenv OLLAMA_MODELS /Volumes/ExtSSD/ollama-models

设完必须完整退出 Ollama 应用再重新打开，仅关闭窗口不算。

五、排查：先看日志

出问题第一步不是重装，是看日志：

## 服务端日志：模型加载、显存分配、请求错误
tail -f ~/.ollama/logs/server.log

app.log 记录的是图形界面的启动与更新行为。区分清楚这两个文件能省很多时间：「模型跑不动」看 server.log，「应用打不开」看 app.log。

常见问题与对应位置：

六、卸载（彻底清理）

macOS 应用常常「删了图标但没删数据」，Ollama 也一样。要彻底清干净，按下面逐条删除：

## 应用本体
sudo rm -rf /Applications/Ollama.app

## CLI 链接
sudo rm /usr/local/bin/ollama

## 应用支持文件与状态
rm -rf "~/Library/Application Support/Ollama"
rm -rf "~/Library/Saved Application State/com.electron.ollama.savedState"

## 缓存
rm -rf ~/Library/Caches/com.electron.ollama/
rm -rf ~/Library/Caches/ollama

## WebKit 数据
rm -rf ~/Library/WebKit/com.electron.ollama

## 模型与配置（这一步会删掉全部已下载模型，几十 GB）
rm -rf ~/.ollama

⚠️ 最后一条是不可恢复的：~/.ollama 里有全部模型权重。只想重装应用、保留模型的话，跳过这一条——新版应用起来后会自动识别已有模型。

七、Mac 上的实用建议

优先用 M 系列芯片。 Metal 后端对 Apple Silicon 的 GPU 支持成熟，统一内存架构还能让模型用上大块显存——64G 内存的 Mac Studio 能跑的模型规模，远超同价位带独显的 PC。

注意统一内存是共享的。 模型占的内存和系统和应用抢，跑大模型时别同时开一堆重负载程序，否则会频繁换页，速度反而更慢。

用 ollama ps 确认是否真的走 GPU。 和 Linux 一样，看 PROCESSOR 列：

ollama ps

显示 100% GPU 才是正常状态。如果出现 CPU 比例，通常是内存不够、模型被拆到 CPU 上了。

其他平台见 7.1 Ollama Linux 安装与部署、7.3 Ollama Windows 安装与部署。