localhost:3000无法连接求助：已按教程配置仍报ERR_CONNECTION_REFUSED

• 确认本地开发服务器状态
  检查启动项目的终端窗口，确认npm run dev/yarn dev这类命令是否正常运行，有没有报错日志。如果服务器启动失败，先修复依赖缺失、代码语法错误等问题。

• 排查端口占用情况
  3000端口可能被其他程序占用，导致服务器无法监听：

  • Windows执行：netstat -ano | findstr :3000，找到对应的PID后，在任务管理器终止该进程
  • macOS/Linux执行：lsof -i :3000，再用kill -9 <PID>结束占用进程
    之后重启服务器，或者修改项目配置切换到其他端口（比如3001）。

• 统一CORS配置与访问协议
  你在Sanity中配置的CORS源是https://localhost:3000，但launch配置里的访问URL是http://localhost:3000，HTTP和HTTPS协议不匹配会导致连接异常。请将Sanity的CORS源改为http://localhost:3000，或者配置本地服务器以HTTPS方式启动。

• 校验launch配置路径
  你的launch配置中webRoot设为${workspaceFolder}，请确认这个路径是项目的根目录（包含package.json的文件夹）。如果项目是多目录结构，需要调整为实际的前端代码目录，比如${workspaceFolder}/frontend。

• 本地端口连通性测试
  在终端执行curl http://localhost:3000，如果返回无法连接的提示，说明服务器根本没监听3000端口，重点排查服务器启动脚本的配置。

• 临时关闭拦截工具
  关闭本地防火墙、VPN或代理软件，这些工具可能会拦截本地端口的连接请求，测试是否能正常访问。

内容的提问来源于stack exchange，提问作者paparonnie