根本原因是项目缺少package.json文件或HBuilderX未正确继承系统环境变量，导致npm无法识别项目或执行命令；需先检查并生成package.json，再确认node/npm路径配置及registry源是否生效。
npm install 报“无法找到模块”或卡在 fetch 阶段
根本原因不是 npm 坏了，而是它压根没读到有效的 package.json，或者根本连不上源。先别急着重装 Node.js —— 90% 的情况是项目里缺这个文件，或 HBuilderX 终端压根没继承系统环境变量。
- 用终端进项目根目录，执行
ls -la（Mac/Linux）或dir（Windows），确认是否存在package.json；没有就立刻运行npm init -y生成一个 - 在 HBuilderX 内置终端里直接输
node -v和npm -v，如果报 “command not found”，说明 Node.js 路径没被识别，不是环境变量没配好，就是 HBuilderX 没读取 shell 启动文件（比如~/.zshrc或~/.bash_profile） - 若命令能执行但
npm install卡住或超时，大概率是源的问题：运行npm config get registry，如果不是https://registry.npmmirror.com，立刻执行npm config set registry https://registry.npmmirror.com
HBuilderX 找不到 node 或 npm，即使系统已安装
这是 macOS（尤其 M1/M2）和使用 Volta/nvm 管理 Node 版本的用户最常踩的坑。HBuilderX 启动时不会自动加载 shell 配置文件，所以它看到的 PATH 和你在终端里看到的完全不同。
Blender Geometry Nodes Script Generator
下载
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
- 不要依赖“全局环境变量已设好”这种假设 —— 在 HBuilderX 中打开「工具 → 设置 → 运行配置」，手动填入
node和npm的绝对路径（例如 Mac 上可能是/Users/xxx/.volta/bin/node，Windows 上是C:\Program Files\nodejs\node.exe） - 如果你用 nvm 或 Volta，
which node返回的路径可能指向 shell wrapper 脚本，HBuilderX 无法执行它；必须填真实二进制路径，比如~/.nvm/versions/node/v18.17.0/bin/node - 改完设置后，重启 HBuilderX —— 不是重启终端，是整个应用，否则新路径不生效
删了 node_modules 重装还是失败
这时候问题往往不在网络或权限，而在缓存损坏、锁文件冲突，或项目路径本身有问题。
- 先清缓存：
npm cache clean --force，别跳过这步，尤其 Windows 用户缓存容易出错 - 删掉
node_modules和package-lock.json（注意不是yarn.lock），再运行npm install；如果项目用的是 yarn，就别硬用 npm - 检查项目路径：不能含中文、空格、括号或 emoji，比如
/Users/小明/Desktop/uniapp(测试)/就会失败，换成/Users/xiaoming/uniapp-test/ - 如果仍报某个包“not found”，复制错误里那个包名（如
vue-loader），单独试装：npm install vue-loader@latest，看是不是版本范围写死了导致解析失败
用外部终端能装，HBuilderX 内置终端死活不行
这不是 bug，是设计如此 —— HBuilderX 内置终端默认不加载用户 shell 初始化逻辑，也不走代理，对 M1/M2 Mac 更敏感。
- 最稳方案：放弃内置终端，在「工具 → 设置 → 运行配置」里勾选「使用外部终端」，然后指定你的 iTerm2 / Terminal / Windows Terminal 路径
- 如果坚持用内置终端，Mac 用户需修改
main.js：路径是/Applications/HBuilderX.app/Contents/HBuilderX/plugins/builtinterminal/script/main.js，把host: '127.0.0.1'改成host: '0.0.0.0'，保存后重启 - Windows 用户遇到“拒绝访问”类错误，基本是权限问题：右键 HBuilderX 快捷方式 → 「以管理员身份运行」，再试一次
