前置条件
- 已安装 Cursor（官网下载）
- 本地有正在运行的项目（Vite / Next.js / Node 服务等）
报错表现
Cursor 右上角提示 Unable to connect to dev server，终端显示：
日志输出
1Error: connect ECONNREFUSED 127.0.0.1:5173解决方法
方法一：检查端口是否被占用
终端命令
1# Windows2netstat -ano | findstr :51733 4# macOS / Linux5lsof -i :5173如果端口被其他进程占用，记下 PID，用任务管理器或 kill 结束该进程，然后重新启动项目。
方法二：清理缓存后重新启动
Cursor 有时会缓存旧的连接信息。执行以下步骤：
- 在 Cursor 右上角点击
Stop停止当前会话 - 关闭 Cursor 窗口
- 终端运行
rm -rf .next node_modules/.vite（清理构建缓存） - 重新
npm run dev - 重新打开 Cursor
方法三：检查 hosts 文件
部分情况下 localhost 解析异常也会导致连接被拒绝：
终端命令
1# 检查 /etc/hosts (macOS/Linux) 或 C:\Windows\System32\drivers\etc\hosts2127.0.0.1 localhost常见报错
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
ECONNREFUSED 127.0.0.1:5173 | 端口未监听 | 确认 dev server 已启动 |
ETIMEDOUT | 防火墙拦截 | 检查系统防火墙规则 |
EADDRINUSE | 端口被占用 | 结束占用进程或换端口 |
相关资源
本篇涉及的开发环境配置问题，如有需要可在商店了解相关 项目模板，包含开箱即用的开发环境配置。
更新记录
- 2026-05-06：首发