VSCode 中无法运行 node 的根本原因是未继承 shell 环境变量；macOS 需检查并 source ~/.zshrc，Windows 需确保 Node 安装时勾选“Add to PATH”或手动添加；npm init/npx 卡住多因权限、缓存或 registry 问题，应避免 sudo、配置 npm prefix 和国内镜像；脚本生成包需注意文件编码、路径拼接和 JSON 格式规范。
VSCode 里跑不了 node，就根本没法生成任何包——因为 npm init、npx create-express-app、甚至你写的脚本生成器，全依赖 node 命令在终端里可用。
VSCode 启动时找不到 node 的真实原因
你在 iTerm 或 PowerShell 里敲 node -v 能出版本号，但 VSCode 里执行命令却报 command not found: node，这不是插件问题，也不是 PATH 写错了，而是 VSCode 没继承 shell 的环境变量。
- macOS：检查
~/.zshrc或~/.bash_profile是否包含export PATH="/usr/local/bin:$PATH"（Homebrew 安装的 Node 默认路径）；改完必须source ~/.zshrc - Windows：重装 Node.js 时务必勾选 “Add to PATH”；若已安装，手动把
C:\Program Files\nodejs\加进系统级PATH - 重启 VSCode 前，关掉所有窗口，用命令行启动：
code --no-sandbox（macOS），或直接双击图标（Windows），避免复用旧 shell 环境
npm init 和 npx 生成包时卡住或报错
常见现象是命令执行后无响应、提示 EACCES 权限错误，或生成的 package.json 缺字段。本质是 npm 当前用户权限、缓存路径或 registry 配置不一致。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 别用
sudo npm init—— 会导致后续npm install权限混乱；改用npm config set prefix ~/.npm-global并把该路径加进PATH - 国内用户建议换 registry：
npm config set registry https://registry.npmmirror.com -
npx调用脚手架（如npx create-react-app）失败时，先清缓存：npx clear-npx-cache，再重试 - 生成 Express 项目时，
npx express-generator@latest myapp比老版本expressCLI 更稳定，避免command not found报错
用脚本批量生成 package.json 或服务骨架时的兼容性陷阱
写 Node 脚本读取模板、注入变量、写入文件，看似简单，但容易在路径、编码、换行符上翻车。
-
fs.readFileSync默认用 UTF-8，但 Windows 上某些编辑器保存的模板文件可能是 GBK，导致中文乱码或 JSON 解析失败；显式指定编码：fs.readFileSync('template.json', 'utf8') - 跨平台路径拼接别用字符串拼
'./src/' + filename，改用path.join(__dirname, 'src', filename) - 生成的
package.json必须是严格 JSON 格式：不能有 trailing comma，键名和字符串值都得用双引号，scripts里的命令别漏引号（如"start": "node index.js"） - 如果脚本依赖
process.argv接收参数，注意 VSCode 的集成终端可能未正确传递参数；建议在终端里手动运行node gen.js --name=mylib
真正卡住你的往往不是语法，而是环境变量没继承、npm 缓存损坏、或脚本读文件时默认编码和实际不符——这些点不提前验，生成出来的包连 npm install 都过不去。
