如何在VSCode中配置Node环境TS-VSCode-PHP中文网

结论：不要在 launch.json 里直接指定 src/index.ts，否则调试必崩；esm 项目不加 "type": "module" 就 import，node 会当场报错。vscode 的 pwa-node 调试器默认只认 javascript 文件，遇到 .ts 后缀会直接拒绝加载；esm 项目必须在 package.json 顶层声明 "type": "module"，否则 import 语句触发 syntaxerror；正确做法是用 prelaunchtask 编译后指向 dist/index.js，或通过 npx ts-node 运行，且需确保 ts-node 已安装并匹配模块配置。

如何在vscode中配置node环境ts

直接说结论：不要在 launch.json 里直接指定 src/index.ts，否则调试必崩；ESM 项目不加 "type": "module" 就 import，Node 会当场报错。

launch.json 配置 TypeScript 调试入口时，别写 `src/index.ts`

VSCode 的 pwa-node 调试器默认只认 JavaScript 文件，遇到 .ts 后缀会直接拒绝加载——不是找不到文件，是根本没尝试解析。

正确做法一：用 preLaunchTask 编译 TS 到 dist/，然后 program 指向 dist/index.js
正确做法二：改用 runtimeExecutable: "npx" + runtimeArgs: ["ts-node", "src/index.ts"]，绕过编译步骤
错误示例："program": "${workspaceFolder}/src/index.ts" → 启动失败，提示 Cannot find module 或直接静默退出
注意：如果用了 ts-node，确保已安装 npm install -D ts-node，且 tsconfig.json 中 "module" 和 "target" 匹配运行时（比如 "module": "commonjs"）

ESM 项目必须在 `package.json` 声明 `"type": "module"`

Node 默认按 CommonJS 解析，import 语句一出现就抛 SyntaxError: Cannot use import statement outside a module。这不是 TS 编译问题，是 Node 运行时模块系统没对齐。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

必须在项目根目录 package.json 顶层加 "type": "module"，不能只靠 tsconfig.json 里的 "module": "esnext"
若同时用 ts-node，需额外加 --loader ts-node/esm（Node 18.12+），或升级 ts-node 到 v10.9.0+ 并启用 esm 选项
漏掉这行会导致：断点能打上，但 require() 失败、process.cwd() 返回路径异常、甚至 __dirname 为 undefined

code-runner 插件跑 TS 时要手动改 `executorMap`

默认的 code-runner 对 .ts 文件执行的是 tsc && node 流程，不支持 ESM，也不走 tsconfig.json 的 outDir 设置，容易和调试配置冲突。

打开 VSCode 设置 → 搜索 code-runner.executorMap → 编辑 JSON
找到 "javascript" 对应的值，改成："node --experimental-specifier-resolution=node $fileName"
再给 "typescript" 单独加一项："ts-node --esm $fileName"（前提是已装 ts-node 且 Node ≥ 18.12）
不改的话，右键“Run Code”可能报错 ReferenceError: __dirname is not defined 或 ERR_REQUIRE_ESM