必须验证ollama本地模型可调用,否则cursor功能静默失败;需启动ollama serve、配置正确模型名与url,并通过快捷键、命令面板或curl任一方式测试成功返回响应即配置完成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Cursor中完成Ollama接入后,必须验证本地模型是否真正可调用,否则后续写代码、补全、解释等功能会静默失败,根本不会报错提示。
启动Ollama服务并确认模型已加载
打开终端,执行 ollama list,检查目标模型(如 llama3 或 qwen2.5)是否出现在列表中。若为空,需先运行 ollama pull llama3 下载模型。
运行 ollama serve 启动服务——这一步不能跳过,Cursor不自带Ollama后台进程,【必须保持该终端窗口持续运行】,关闭即断连。
在Cursor中配置Ollama为默认AI提供商
点击左下角设置图标 → Settings → AI → Provider → 选择 “Ollama”。
在 “Model” 输入框中填入你已下载的模型名,例如 llama3(注意:不能带版本号如 llama3:8b,除非你在Ollama中显式重命名过)。
确保 “Ollama Host URL” 为默认值 http://localhost:11434;如果改过端口,务必同步更新此处,否则连接超时无提示。
发起一次最小化测试请求
方法一:快捷键触发
在任意代码文件中,选中一段简单代码(比如 console.log("hello")),按下 Cmd+K(Mac)或 Ctrl+K(Win/Linux),输入“解释这段代码”,回车。
方法二:命令面板调用
按下 Cmd+Shift+P → 输入 “Ollama: Chat” → 回车 → 在弹出的对话框里输入 “你好”,然后发送。
方法三:终端内直连验证(绕过Cursor)
新开一个终端,执行:curl http://localhost:11434/api/chat -d '{"model":"llama3","messages":[{"role":"user","content":"hi"}]}'。如果返回包含 "done":true 的JSON块,说明Ollama服务本身正常;若返回 connection refused,则 Cursor肯定无法连上。
只要其中任一方式返回非空响应且无报错,就代表配置成功。如果光标长时间转圈后显示 “Failed to connect to Ollama”,请立即检查 ollama serve 是否仍在运行、模型名是否拼错、防火墙是否拦截了11434端口。











