Cursor接入Ollama后模型不显示，需依次检查：一、确认ollama serve监听0.0.0.0:11434而非仅127.0.0.1；二、设置OLLAMA_HOST环境变量强制全接口绑定；三、Cursor中API地址填http://127.0.0.1:11434/api/chat且模型名与ollama list输出完全一致；四、WSL2下用主机真实IP并开放防火墙端口；五、通过curl测试/api/chat端点验证协议匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor接入Ollama后模型不显示，说明编辑器已尝试连接服务但未能正确识别或加载可用模型列表，常见于模型名称不匹配、服务监听地址受限、API端点路径错误或环境变量未生效等环节。
确认Ollama服务正在运行且可访问
打开终端，执行 ollama serve 启动服务（若已后台运行，先用 pkill ollama 杀掉旧进程再重启）。
执行 curl -s http://localhost:11434/api/tags | jq '.models | length' —— 若返回数字 0 或报错 Failed to connect，说明服务未响应或绑定异常。
关键验证：运行 lsof -i :11434（macOS/Linux）或 netstat -ano | findstr :11434（Windows），输出中必须含 0.0.0.0:11434 或本机局域网IP（如 192.168.1.100:11434），仅出现 127.0.0.1:11434 会导致Cursor在WSL或远程场景下无法访问。
检查模型是否真实存在并被ollama list识别
在终端运行 ollama list，观察输出是否为空或仅显示部分模型。
若为空，手动检查模型文件是否存在：macOS/Linux 执行 ls ~/.ollama/models，Windows 查看 C:Users[用户名].ollamamodels 目录——若该目录下有子文件夹（如 llama3.2-3b），说明模型已下载但未注册。
此时需重新注册模型：进入对应模型文件夹，确认内含 Modelfile，然后执行 ollama create llama3.2:3b -f ./Modelfile（注意冒号后版本号须与 ollama list 期望格式一致）。
【重要】模型名必须完全匹配：例如 ollama list 显示 qwen3:4b，则 Cursor 设置中 Model Name 字段只能填 qwen3:4b，多一个空格、少一个冒号或大小写错误都会导致不显示。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
修正Cursor中的Ollama配置项
打开 Cursor → Settings → AI → Model Provider，选择 Ollama。
方法一：本地直连（推荐开发机单机使用）
→ Ollama API URL 填 http://127.0.0.1:11434/api/chat
→ Model Name 填 llama3.2:3b（必须与 ollama list 输出逐字一致）
方法二：跨环境适配（WSL/容器/Docker Desktop）
→ 先在宿主机执行 ipconfig（Windows）或 ifconfig | grep "inet " | grep -v "127.0.0.1"（macOS/Linux）获取真实局域网IP
→ Ollama API URL 填 http://[查到的IP]:11434/api/chat（例如 http://192.168.1.50:11434/api/chat）
→ 确保宿主机防火墙放行 11434 端口，且 WSL 中 /etc/resolv.conf 的 nameserver 指向宿主IP
方法三：强制全接口监听（解决 127.0.0.1 绑定限制）
第一步：关闭当前 ollama 进程
第二步：设置环境变量 OLLAMA_HOST=0.0.0.0:11434
第三步：重新执行 ollama serve
第四步：浏览器访问 http://localhost:11434/api/tags 应返回完整 JSON 模型列表
排除VS Code/Cursor启动环境隔离问题
如果通过桌面图标启动 Cursor，它可能无法读取 shell 配置文件（如 ~/.zshrc）中定义的 OLLAMA_HOST 或 PATH。
验证方式：在 Cursor 内置终端中执行 echo $OLLAMA_HOST 和 which ollama，若均为空，则说明环境变量未加载。
解决方案：macOS 用户改用终端命令 open -a Cursor 启动；Windows 用户右键开始菜单 Cursor 图标 → “更多” → “打开文件位置”，右键快捷方式 → 属性 → “起始位置”改为 %USERPROFILE%，并在“目标”末尾添加 --env=OLLAMA_HOST=0.0.0.0:11434。
验证API端点是否符合OpenAI兼容协议
Ollama v0.1.40+ 默认要求 POST 请求发送至 /api/chat，而非根路径 / 或 /v1/chat/completions。
手动测试命令：
curl -X POST http://127.0.0.1:11434/api/chat \<br>
-H "Content-Type: application/json" \<br>
-d '{"model":"llama3.2:3b","messages":[{"role":"user","content":"hi"}]}'
若返回 {"error":"model not found"}，说明模型名拼写错误；若返回 {"error":"invalid request"} 或超时，说明端点路径或协议不匹配。
【关键区别】：LM Studio 需用 http://localhost:1234/v1/chat/completions，而 Ollama 必须用 /api/chat —— 混用会导致模型始终不显示。
