cursor接入ollama失败时需逐层排查：确认ollama监听0.0.0.0:11434、设置ollama_host环境变量、按场景配置正确api url（localhost/wsl主机ip/云端base_url）、修复path环境变量、验证curl调用/api/chat返回流式json。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor接入Ollama时提示接口错误，说明AI功能无法正常调用本地模型，常见表现为状态栏显示“Not Connected”、Cmd/Ctrl+K无响应、开发者工具Network面板中/v1/models请求返回404或timeout，此时必须逐层验证服务可达性与配置一致性，不能仅靠重启解决。
确认Ollama服务真实监听地址
打开终端执行lsof -i :11434（macOS/Linux）或netstat -ano | findstr :11434（Windows），观察输出中是否含*:11434或0.0.0.0:11434；若只显示127.0.0.1:11434，则Cursor在WSL、远程窗口或沙盒环境中根本无法访问该服务。
运行curl http://localhost:11434/api/version应返回JSON版本信息；若失败，说明服务未启动或端口被占——此时ollama serve可能已在后台静默运行但未生效，需先pkill ollama再重启。
关键一步：设置环境变量强制全接口监听。macOS/Linux执行export OLLAMA_HOST=0.0.0.0:11434，Windows PowerShell执行$env:OLLAMA_HOST="0.0.0.0:11434"，然后启动ollama serve。这步漏掉，后续所有配置都无效。
修正Cursor中的API端点格式
方法一：本地直连（推荐开发机单机使用）
打开Cursor设置 → AI → Model Provider → Ollama → Ollama API URL填http://localhost:11434/api/chat，Model Name填qwen3:4b（必须与ollama list输出完全一致，包括大小写和冒号后缀）。
方法二：WSL2跨子系统访问（Windows用户常见场景）
先在WSL中执行cat /etc/resolv.conf | grep nameserver | awk '{print $2}'获取主机IP，例如192.168.44.1；
Cursor中Ollama API URL填http://192.168.44.1:11434/api/chat；
【Windows防火墙必须放行11434端口】，否则即使IP正确也连接超时。
方法三：云端模型（如minimax-m2:cloud）
BASE_URL填https://ollama.com，AUTH_TOKEN填Ollama官网Settings → Keys生成的API Key，MODEL填minimax-m2:cloud；
注意：此处不走本地11434端口，填localhost会直接报ConnectionRefused。
排查VS Code/Cursor启动环境隔离问题
第一步：在Cursor内置终端中执行which ollama，若返回空，说明CLI不在PATH中；
第二步：执行echo $PATH，对比系统终端输出，常见差异是/usr/local/bin或~/bin缺失；
第三步：macOS用户需从终端启动Cursor：open -a Cursor，避免Dock快捷方式导致环境变量丢失；
第四步：Windows用户需将ollama安装路径（如C:\Users\XXX\AppData\Local\Programs\Ollama）加入系统PATH，并重启Cursor。
这一步绕不开——VS Code桌面图标启动时加载的是最小化环境，不会读取~/.zshrc或用户环境变量，而Cursor插件进程完全继承该环境。
验证模型端点可用性
在终端中执行以下命令，直接测试Ollama服务是否响应标准API：
curl -X POST http://localhost:11434/api/chat -H "Content-Type: application/json" -d '{"model":"qwen3:4b","messages":[{"role":"user","content":"hi"}]}'
若返回流式JSON（含message.content字段），说明服务与模型均正常；若报model not found，检查ollama list输出是否真有该模型名；若报connection refused，回到第一步重新检查监听地址。
