vscode中npm init没反应或package.json报错，主因是路径错误、未设"type":"module"及launch.json的program字段误用"${file}"。需确认终端路径、初始化时执行npm init -y && npm pkg set type=module，并将program改为"${workspacefolder}/index.js"。
VSCode 里敲 npm init 没反应，或者生成的 package.json 一跑就报错，不是你命令输错了，而是初始化环节漏掉了几个关键动作——尤其是路径、模块类型和调试入口这三处，90% 的新手卡在这儿。
npm init 没反应？先盯住终端当前路径
VSCode 内置终端默认打开位置不固定，尤其多工作区时容易落在用户主目录或上一个项目里。它不会自动跳转到你刚用「文件 → 打开文件夹」选中的项目根目录。
- 按
Ctrl + `唤出终端后，立刻执行pwd（macOS/Linux）或cd（Windows），看输出是不是你的目标项目路径 - 如果不是，用
cd /your/project/path切过去，再运行npm init -y - 别依赖右键菜单里的「在终端中打开」——某些 VSCode 版本会打开错误工作区，尤其从资源管理器拖入文件夹时
生成的 package.json 缺 "type": "module" 怎么办
Node.js 默认用 CommonJS（require()），但你现在写的代码大概率是 import/export。不声明模块类型，运行就报 Cannot use import statement outside a module。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 最稳写法：初始化时一步到位，运行
npm init -y && npm pkg set type=module（要求 Node.js ≥ 14.13） - 手动补也行：打开
package.json，在顶层加一行"type": "module"，注意逗号位置，别破坏 JSON 结构 - 加了之后，所有
.js文件都按 ES Module 解析，require()会直接报错；反之没加，import就挂——二者不能混用
launch.json 的 program 字段别写 "${file}"
VSCode 自动创建的调试配置常设 "program": "${file}"，看着方便，实则极易翻车：你在 utils/helper.js 里点 F5，调试器真就只跑这个文件，没上下文、没 require 链，直接报 Cannot launch program because corresponding JavaScript cannot be found。
- 生产级写法：固定入口，比如
"program": "${workspaceFolder}/index.js"或"program": "${workspaceFolder}/src/index.js" - 如果用 TypeScript，
launch.json必须配"preLaunchTask": "tsc: build"，且"outFiles"指向编译后路径（如["${workspaceFolder}/dist/**/*.js"]） - Windows 用户注意：路径一律用
/，写\会触发转义，VSCode 内部自动处理，不用管本地系统分隔符
code-runner 插件跑 Node 脚本的三大硬伤
code-runner 看似“一键运行”，但它绕过了 npm script 流程和 VSCode debugger，本质就是调 node xxx.js，导致很多隐性问题。
- 断点完全不生效——因为不是 debugger 启动的进程
- ES Module 文件直接报错——它不加
--experimental-specifier-resolution=node参数 - 交互式脚本（比如
readline）卡死——code-runner不支持 stdin 输入流 - 替代方案：要么用 VSCode 自带调试（F5），要么在终端手动跑
node --experimental-specifier-resolution=node index.js
真正省事的初始化，不是堆插件，而是把 package.json 的 type 和 scripts、.vscode/launch.json 的 program、以及终端能否识别 npm 这三件事对齐。少一个，后面每写一行代码都在填坑。
