根本原因是cursor未连接到本地ollama服务，需确认ollama监听0.0.0.0:11434、设置ollama_host环境变量、正确配置api url为http://127.0.0.1:11434/api/chat、模型名严格匹配ollama list输出，并确保防火墙放行11434端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor接入Ollama时提示“Connection refused”“Model not available”或右下角状态栏持续显示灰显，根本原因不是模型没装好，而是Cursor客户端根本没连上你本机跑着的Ollama服务——它连请求都发不出去，更别说加载模型了。
确认Ollama服务是否真在监听可访问地址
第一步：打开终端，执行 ollama serve 启动服务（如果已后台运行，先用 pkill ollama 杀掉再重启）。
第二步：检查监听状态。macOS/Linux运行 lsof -i :11434，Windows运行 netstat -ano | findstr :11434。
第三步：重点看输出里有没有 【0.0.0.0:11434】 或你的局域网IP（如 192.168.1.100:11434）。如果只看到 127.0.0.1:11434，说明Ollama正躲在“自闭模式”里，拒绝任何外部连接——包括Cursor发起的请求。
强制Ollama绑定全接口（关键一步）
方法一（推荐）：设置环境变量 OLLAMA_HOST 再启动服务。
macOS/Linux终端中执行：export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
Windows命令提示符中执行：set OLLAMA_HOST=0.0.0.0:11434 && ollama serve
PowerShell中执行：$env:OLLAMA_HOST="0.0.0.0:11434"; ollama serve
⚠️ 注意：这一步必须在启动 ollama serve 前完成，否则无效。重启服务后，立刻访问 http://localhost:11434/api/tags，能返回JSON列表才算成功。
Cursor中填对API地址和模型名
打开 Cursor 设置 → AI → Model Provider → 选择 Ollama。
Ollama API URL 填：
本地开发用 http://127.0.0.1:11434/api/chat；
WSL2或Docker场景用 http://[你的主机真实IP]:11434/api/chat（不是127.0.0.1）。
Model Name 必须与 ollama list 输出的名称完全一致，包括大小写、冒号和版本号，例如 qwen3:4b 或 llama3.2:3b。
不填 /api/chat 路径会导致404；填错模型名会返回空列表或500错误；用 https 协议会直接失败——Ollama默认不支持HTTPS。
WSL2用户必须额外做的两件事
① 在Windows主机上，用 ipconfig 查出以太网适配器的IPv4地址（比如 192.168.1.123），这个才是WSL2能访问的真实IP。
② Windows防火墙要放行端口11434：控制面板 → Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则 → 端口 → TCP 11434 → 允许连接 → 命名保存。
别用 localhost 或 127.0.0.1 去连宿主机，WSL2里这两个地址指向的是WSL自己的环回，不是Windows主机。
验证连接是否真正通了
在终端中执行这条命令：curl -X POST http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d '{"model":"llama3","messages":[{"role":"user","content":"hi"}]}'
如果返回流式JSON响应（含message.content字段），说明Ollama服务本身健康且路径正确；如果报 Connection refused，问题仍在服务层；如果返回 404 Not Found，说明URL少写了 /api/chat。
