必须先安装 node.js 18.x 或 20.x lts 版本并确保 cursor 识别到，再通过新建文件夹+index.js 或 npm init -y 创建项目，安装 express 后配置 package.json scripts 和 launch.json，才能成功运行与调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手想用Cursor开发Node.js项目，需要从零配置环境、创建可运行的脚本、安装依赖到调试运行全部打通，不能只写代码却卡在终端报错或调试器连不上。
安装并配置Cursor基础环境
打开官网 cursor.sh 下载对应系统的安装包，双击完成安装，启动后首次会自动检测系统是否已安装 Node.js。
如果弹出「Node.js not found」提示，【必须先安装 Node.js 18.x 或 20.x LTS 版本】，否则后续所有命令都会失败；不要用 nvm 管理多个版本后再启动 Cursor，它默认只读取系统 PATH 中第一个 node 可执行文件。
确认终端里输入 node -v 能返回版本号，再重启 Cursor，状态栏右下角才会显示 Node.js 图标。
新建一个可立即运行的Node.js项目
方法一：使用内置模板快速初始化
点击左上角 File → New Folder → 命名为 my-node-app → 回车确认 → 在空文件夹内右键 → New File → 输入 index.js → 按 Ctrl+S 保存。
在 index.js 中输入 console.log('Hello from Cursor'); → 按 Ctrl+Shift+P → 输入 Run Code → 选择 Run Code in Terminal → 观察底部终端输出结果。
方法二：用 npm init 生成完整项目结构
在项目根目录右键 → Open in Integrated Terminal → 输入 npm init -y → 回车生成 package.json → 再手动创建 index.js 并写入 process.exit(0); → 这样 package.json 的 "main" 字段才指向有效入口文件，否则后续调试会报错“Cannot find module”。
安装并管理npm依赖
第一步：在终端中执行 npm install express —save，安装 Express 框架并写入 dependencies。
第二步：打开 index.js，粘贴以下代码：
const express = require('express');
const app = express();
app.get('/', (req, res) => res.send('OK'));
app.listen(3000, () => console.log('Server running on http://localhost:3000'));
第三步：在 package.json 的 scripts 字段中添加 "start": "node index.js"，这样后续就能用 npm start 启动服务，而不是每次都在终端敲 node index.js。
注意：不要直接在 Cursor 编辑器里右键「Run」来执行含 listen() 的服务脚本，它会阻塞主线程导致无法热重载；必须通过终端命令或配置 launch.json 启动。
配置调试器让断点生效
点击左侧活动栏的调试图标（虫子图标）→ 点击「create a launch.json file」→ 选择 Node.js → 自动生成 .vscode/launch.json。
将生成的 configuration 中的 "program" 字段值改为 "${workspaceFolder}/index.js"，确保路径指向你的真实入口文件。
在 index.js 的 app.listen() 上方行号左侧单击设置断点 → 按 F5 启动调试 → 浏览器访问 http://localhost:3000 → 断点被触发，变量面板显示 req/res 对象内容。
这一步若失败，大概率是 launch.json 中 program 路径写错，或者 index.js 文件名拼写不一致（比如写成 Index.js 或 main.js 却没同步改配置）。
