最近在使用 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 的备用方案。虽然它的速度略慢，但在不稳定网络下，反而更可靠。
可以按照下面的步骤来开启：
- 打开 Cursor 设置（快捷键
Cmd或Ctrl+,） - 进入 VS Code Settings
- 搜索关键词
http2 - 勾选 “Disable HTTP/2” 选项
这样就会强制 Cursor 使用 HTTP/1.1，从而避开网络兼容性问题。
✅ 设置完成后，连接错误大多会消失，使用起来也顺畅多了，就是会有点慢。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。