如何解决 Cursor 中的 “Connection failed” 错误

在使用 Cursor 时，如果你经常看到以下报错：

“Connection failed. If the problem persists, please check your internet connection or VPN”

你并不是一个人遇到这个问题。即使网络一切正常，这个错误仍可能突然出现，严重影响使用体验。

为什么会出现这个错误？

Cursor 使用 HTTP/2 协议来支持它的 AI 功能，因为它可以实现流式响应。但并不是所有网络都能很好地支持 HTTP/2。

如果你使用的是公司网络、VPN，或代理（比如 Zscaler），HTTP/2 连接可能会失败，导致代码无法索引或 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，从而避开网络兼容问题，恢复 AI 功能的正常使用。

✅ 设置完成后，连接失败的问题一般会消失，使用体验将更加稳定。

参考链接

• Cursor 官方论坛：关于连接失败的讨论
• Cursor 官方文档：网络连接问题（HTTP/2）