将Node脚本设为全局软链接命令后，遭遇fs/promises模块找不到错误

可能原因与对应解决方法 #

1. 全局执行时调用了旧版本Node #

虽然你安装了Node v21.1.0，但全局命令可能默认调用系统自带的旧版本Node（Debian 11默认Node版本较低，不支持fs/promises的直接导入）。

• 验证：运行mycommand前执行which node查看当前全局Node路径，或在start.js开头添加console.log(process.version)，运行mycommand确认输出版本是否为v21.1.0。
• 修复：
  • 用update-alternatives切换默认Node版本：

    sudo update-alternatives --install /usr/bin/node node /path/to/your/node21/bin/node 100
    sudo update-alternatives --config node
    

    选择对应v21.1.0的选项即可。
  • 或修改PATH优先级，编辑~/.bashrc或~/.profile：

    echo 'export PATH="/path/to/your/node21/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc
    

2. 脚本缺少正确的Shebang行 #

全局执行脚本时，系统可能未使用预期的Node版本运行，需在start.js第一行添加指定解释器的Shebang：

• 在start.js最顶部添加：

  #!/usr/bin/env node
  

  确保这是文件第一行，无前置空行或注释。然后重新设置执行权限：

  chmod +x /var/www/a/start.js
  

3. 软链接路径错误 #

检查软链接是否指向正确的脚本路径：

• 执行ls -l /usr/bin/mycommand查看软链接目标，确认与实际脚本路径/var/www/a/start.js一致。若路径错误，重新创建软链接：

  sudo rm /usr/bin/mycommand
  sudo ln -s /var/www/a/start.js /usr/bin/mycommand
  

4. 用npm link替代手动软链接 #

手动软链接可能无法正确关联项目依赖，改用npm全局链接功能：

• 进入项目目录/var/www/a，执行：

  npm link
  

  该命令会自动创建全局命令（需package.json配置bin字段），同时确保脚本能正确读取项目node_modules。

内容的提问来源于stack exchange，提问作者Rehamjf