新手用cursor搭建node.js项目需避开四大坑：①用npm init -y而非react命令初始化；②node须≥18.17.0且npm≥9.6.0；③删settings.json中experimental字段；④mcp.json须严格json格式并正确引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手用Cursor搭建Node.js项目时，常在初始化命令、环境版本、配置字段和MCP服务连接四个环节栽跟头，轻则项目无法启动，重则AI反复生成错误代码却查不出原因。
初始化命令写错导致项目结构异常
第一步：打开Cursor终端，输入npx create-react-app my-app --template typescript——这是React项目的命令，不是Node.js的。
第二步：Node.js项目应使用npm init -y或pnpm init -y，直接生成package.json即可。若想带框架，改用npx express-generator@4 my-app（注意指定v4，v6默认启用ESM，与多数Cursor内置模板不兼容）。
第三步：执行后检查package.json中"type"字段——若为"module"，但代码里还用require()，运行必报ERR_REQUIRE_ESM。此时要么全切ESM语法，要么删掉该字段，改用exports字段做兼容导出。
Node.js版本不匹配引发命令崩溃
方法一：在终端运行node -v，确认输出为v18.17.0或更高。若显示v14.x或v16.13.0，【必须升级】——因为Cursor CLI、@composio/mcp、最新express-generator均要求Node ≥18.0.0。
方法二：用nvm管理多版本（Windows用户装nvm-windows）。执行nvm install 18.17.0 && nvm use 18.17.0，再验证node -v和npm -v。旧版npm（如6.x）会触发ENOTSUP错误，必须同步升级到npm ≥9.6.0。
方法三：安装完成后，在Cursor设置中关闭“自动检测Node路径”，手动指定node.exe绝对路径（例如C:\Users\XXX\nvm\v18.17.0\node.exe），否则Cursor可能仍调用系统残留的旧版。
settings.json配置字段已废弃却照抄旧教程
打开Cursor命令面板（Ctrl+Shift+P），执行Preferences: Open Settings (JSON)。
删除所有含experimental字样的配置项，例如"cursor.experimental.ai.autocomplete"——该字段在v0.42+中已被移除，保留会导致AI功能静默失效。
只保留这三行关键配置：
"cursor.ai.inline.suggestions.enabled": true,
"cursor.ai.chat.defaultModel": "claude-3-haiku",
"cursor.ai.apiKeySource": "env"
最后一行强制AI从环境变量读密钥，避免把CURSOR_AI_API_KEY硬编码进JSON——否则团队协作时密钥直接泄露。
配MCP服务时JSON格式错误却不报具体位置
第一步：在项目根目录创建mcp.json，内容必须是严格JSON格式——不能有注释、尾随逗号、单引号。
第二步：字段名必须小写且拼写精准："server"不能写成"Server"或"service"；"port"值必须为数字，不能是字符串"3001"。
第三步：检查package.json中scripts是否包含"mcp:start": "node mcp-server.js"，且mcp-server.js文件真实存在。若脚本名与实际文件名不一致，Cursor调用MCP时会返回spawn ENOENT，但错误提示里不显示缺失的是哪个文件。
第四步：启动MCP服务后，在Cursor聊天框输入@mcp.json再提问，确保AI能读取该配置——不加@引用，AI根本看不到这个文件。
