解决 Cursor 连接失败的小技巧(Connection failed)

3,292 阅读1分钟

最近在使用 Cursor 的过程中,时不时会遇到这样一条报错:

“Connection failed. If the problem persists, please check your internet connection or VPN”
(连接失败。如果问题持续出现,请检查你的网络或 VPN 设置)

这个提示通常出现在没有任何征兆的情况下,即使你的网络连接一切正常,也有可能突然断掉,影响使用体验。

问题出在哪里?

Cursor 的许多 AI 功能依赖 HTTP/2 协议,因为它支持流式响应。然而,并不是所有网络都支持 HTTP/2,尤其是在以下场景下:

  • 公司或内网环境

  • 使用 VPN

  • 走代理,例如 Zscaler

一旦 HTTP/2 被拦截或连接不稳定,Cursor 就可能无法索引代码,也无法正常调用 AI,最终导致连接失败的错误提示。

解决办法:关闭 HTTP/2

幸运的是,Cursor 已经提供了 HTTP/1.1 的备用方案。虽然它的速度略慢,但在不稳定网络下,反而更可靠。

你可以按照下面的步骤来开启:

  1. 打开 Cursor 设置(快捷键 Cmd 或 Ctrl + ,

  2. 进入 VS Code Settings

  3. 搜索关键词 http2

  4. 勾选  “Disable HTTP/2”  选项

这样就会强制 Cursor 使用 HTTP/1.1,从而避开网络兼容性问题。

✅ 设置完成后,连接错误大多会消失,使用起来也顺畅多了

不过,禁用 HTTP/2 后,Cursor 的响应速度会稍微慢一点,不过,至少不会再出现一直断开链接的情况了,希望 Cursor 能够早点修复这个问题。

打开 VS Code 设置

禁用 HTTP2

参考资料