接手老Node.js项目用Cursor修改代码前，须确保环境识别正确、依赖加载完整、调试配置就绪；需通过「Open Folder in Cursor」触发workspace初始化，手动指定本地Node路径，区分CommonJS与ESM模块系统，修改Express路由时注意async标记及类型补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你接手一个老的Node.js项目，用Cursor编辑器修改代码时，必须先确保环境识别正确、依赖加载完整、调试配置就绪，否则改完代码运行报错才发现TS类型缺失或ESM语法不兼容，返工成本很高。
确认项目基础配置是否被Cursor识别
打开项目根目录，在侧边栏右键 → 选择「Open Folder in Cursor」，不要双击文件夹直接打开，否则可能跳过workspace初始化流程。
等待左下角状态栏出现「Node.js detected」提示，若显示「No SDK configured」或长时间卡在「Loading dependencies…」，说明package.json未被正确解析。
此时手动点击左下角齿轮图标 → 「Settings」→ 搜索「nodejs」→ 在「Node.js: Runtime Version」中【手动指定项目本地node版本路径，例如./node_modules/.bin/node】，避免Cursor默认调用全局Node导致require.resolve失败。
快速定位并修改核心逻辑文件
方法一：Ctrl+P（Win）/Cmd+P（Mac）呼出快速打开面板，输入文件名关键词（如server.js、app.ts、index.mjs），直接跳转。
方法二：在Explorer中展开src或lib目录，注意区分.js/.ts/.mjs后缀——老项目常见混合写法，【修改前务必确认当前文件实际执行时的模块系统（CommonJS还是ESM）】，否则require()和import混用会触发SyntaxError。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
方法三：右键任意函数名 →「Go to Definition」，可穿透node_modules查看第三方包源码，但对老项目慎用此功能，某些v1.x版本包无类型声明，跳转会失败并阻塞后续操作。
安全修改Express路由处理函数
第一步：在路由文件中找到目标路由，例如app.get('/api/users', ...)。
第二步：光标停在回调函数参数位置，按Ctrl+Shift+I（Win）/Cmd+Shift+I（Mac）触发Cursor智能补全，自动注入req、res、next类型定义（即使原项目无@types/express也会尝试推导）。
第三步：修改业务逻辑时，如果新增了异步操作，检查函数是否已标记async；若未标记，直接写await会导致运行时报错「SyntaxError: await is only valid in async function」。
第四步：保存前右键选中修改行 →「Cursor: Generate Unit Test」，自动生成Jest测试桩，填入预期返回值即可验证修改不影响原有行为。
