Windows环境Bash脚本仅在-v模式下正常运行，如何排查故障？

我有一段开头如下的Bash脚本：

#!/bin/bash
echo "Running on OSTYPE: '$OSTYPE'"
DISTRO=""
CODENAME=""
SUDO=$(command -v sudo 2>/dev/null)

echo foo

直接运行脚本或用bash -x执行时，脚本会在完成SUDO变量赋值后停止，仅输出：

+ DISTRO=
+ CODENAME=
++ command -v sudo
+ SUDO=

但用bash -v调用时，脚本能正常运行，可看到输出"foo"。我使用的是从Git官网下载的bash 4.4.23版本，请问该如何排查这个问题？

这种仅在特定执行模式下出现的异常，大概率和bash的输出缓冲、脚本格式或版本bug有关，可按以下步骤调试：

• 检查脚本换行符
  Windows下的CRLF换行符会导致bash解析异常，尤其是命令替换环节。用cat -A 脚本名查看每行结尾：

  • 正常Bash脚本应为$结尾（LF换行）
  • 如果看到^M$（CRLF换行），用dos2unix 脚本名转换格式

• 拆分命令替换步骤
  把SUDO=$(command -v sudo 2>/dev/null)拆分成多步执行，定位卡顿环节：

  #!/bin/bash
  echo "Running on OSTYPE: '$OSTYPE'"
  DISTRO=""
  CODENAME=""
  echo "Before command substitution"
  CMD_RESULT=$(command -v sudo 2>/dev/null)
  echo "Command substitution result: '$CMD_RESULT'"
  SUDO=$CMD_RESULT
  echo foo
  

  用bash -x运行，观察在哪一步停止，判断是命令替换本身还是赋值环节出问题。

• 禁用输出缓冲
  Bash在非交互式模式下可能启用行缓冲，尝试强制输出到无缓冲的stderr：

  # 修改关键输出行
  echo "Running on OSTYPE: '$OSTYPE'" >&2
  

  或者在脚本开头添加export PYTHONUNBUFFERED=1强制关闭缓冲，看是否能显示完整内容。

• 排除环境变量干扰
  部分环境变量（如PS1、PROMPT_COMMAND）或自定义Bash函数可能干扰执行。用env -i bash -x 脚本名在干净环境下运行，验证是否是环境导致的问题。

• 测试版本兼容性
  bash 4.4.23是较旧版本，可能存在已知bug：

  • 尝试升级到bash 5.x版本，看问题是否消失
  • 用系统自带的bash（若有）运行脚本，对比结果

• 开启双重调试日志
  用bash -x -v 脚本名同时开启跟踪和详细输出，对比两种模式下的执行差异，定位停止的具体原因。

内容的提问来源于stack exchange，提问作者Jean-Michaël Celerier