Linux环境下Yargs参数绑定异常问题求助

核心异常分析 #

你遇到的错误提示.ommand not found: command1有个关键细节：command前多了一个点且缺失首字母c，结合「直接终端执行正常、脚本调用异常」的差异，问题大概率出在脚本本身的参数传递、字符编码或环境差异上，和Yargs核心逻辑无关。

分步排查动作 #

1. 检查脚本的命令拼写与调试输出 #

直接在command1.sh中添加调试行，打印待执行的完整命令，确认参数是否变形：

#!/bin/bash
# 打印待执行命令，排查参数是否异常
echo "Executing command: node RunCommand.js --command command1"
# 原脚本中的环境变量设置
export YOUR_ENV_VAR=xxx
# 原执行命令
node RunCommand.js --command command1

运行脚本后查看echo输出，如果显示的命令里--command变成--.ommand或其他变形，说明脚本里的参数拼写有误（比如手滑多打了点、少打了字母）。

2. 排查脚本中的不可见控制字符 #

如果脚本是在Windows环境编辑的，会携带Windows换行符（^M）或其他控制字符，导致shell解析参数时变形。用以下命令查看脚本原始字符：

cat -A command1.sh

如果看到行尾有^M或--command附近有奇怪字符，用dos2unix转换脚本格式：

dos2unix command1.sh

3. 对比脚本与终端的shell环境差异 #

脚本开头的#!/bin/sh和终端默认的bash可能存在参数展开、引号处理的差异：

• 把脚本开头的#!/bin/sh改成#!/bin/bash，和终端环境保持一致
• 检查脚本里的环境变量设置，有没有覆盖或干扰Yargs的参数读取（比如export了COMMAND变量，导致Yargs误读）

4. 验证脚本工作目录与文件路径 #

脚本可能通过cd切换了工作目录，导致RunCommand.js的相对路径失效。在脚本里添加当前目录打印：

echo "Current working dir: $(pwd)"

如果路径不对，把RunCommand.js改成绝对路径即可。

大概率根因 #

最常见的触发场景是：

• 脚本编辑时手滑把--command写成--.command（多了一个点）
• 脚本携带Windows换行符，导致参数被shell解析变形
• 脚本里的环境变量设置意外修改了Yargs依赖的变量

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