必须确保node.js≥v20.0.0且npm可用，优先用npm create vite@latest初始化react项目，严格按cd→npm install→npm run dev顺序执行，修改app.jsx后能秒级热更新即表示环境与cursor链路跑通。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中开发React项目前，必须确保本地具备可运行的Node.js环境和基础构建能力，否则新建项目会卡在依赖安装或启动阶段，连初始页面都看不到。
确认Node.js与npm已就绪
打开Cursor内置终端（Ctrl+` 或 Cmd+`），执行：
node -v && npm -v
若提示“command not found”或版本低于【v20.0.0】，说明Node未安装或未加入系统PATH——此时Cursor无法调用npm创建项目，必须先去nodejs.org下载LTS版并完成安装。
Windows用户安装时务必勾选“Add to PATH”，macOS用户若用Homebrew安装，需确保~/.zshrc中已写入export PATH="/opt/homebrew/bin:$PATH"。
选择初始化方式：Vite优先
Cursor对Vite支持更原生，热重载响应快、TS类型提示准，且避免create-react-app遗留的Webpack配置黑盒问题。
方法一：终端直输命令
npm create vite@latest my-react-app -- --template react
方法二：用Cursor快捷指令（需已启用AI命令）
按下Cmd+K（macOS）或Ctrl+K（Windows），输入“create new React app with Vite”，回车后按提示填项目名和模板类型。
注意：不要用npx create-react-app——它默认拉取旧版React 18模板，且内置的scripts不兼容Cursor的实时预览面板，后续改端口或加代理容易报错。
进入项目并安装依赖
第一步：cd my-react-app
第二步：npm install
第三步：npm run dev
这三步必须严格按顺序执行。跳过npm install直接run dev会导致node_modules缺失，终端报错“Cannot find module ‘vite’”，且Cursor右下角状态栏会持续显示“Starting dev server…”却无响应。
启动成功后，终端会输出类似“Local: http://localhost:5173”的地址——这时别急着复制浏览器打开，先在Cursor左侧资源管理器里点开src/App.jsx，任意修改一句文本，保存后观察右上角是否立刻刷新出新内容。能秒级响应，才说明Vite+Cursor链路真正跑通。
