VSCode不支持Shell脚本原生单步调试，最可靠方案是bash -x + set -x配合read手动暂停；bashdb需独立安装且launch.json须显式指定路径，Code Runner等快捷执行默认用/sh不兼容bash特性。
VSCode 本身不支持 Shell 脚本的原生单步调试（没有变量监视、断点停靠、调用栈等），所谓“单步”只能靠 bash -x 模拟，这是当前技术条件下最可靠、最轻量、最不依赖插件的方式。
为什么 F5 调试总失败：bashdb 不是 VSCode 自带功能
VSCode 的调试系统必须通过外部调试器驱动，bashdb 就是那个外部命令。它不是 VSCode 插件，而是独立安装的 CLI 工具：
-
bashdb在 macOS 上需brew install bashdb；Ubuntu/Debian 需sudo apt install bashdb（注意：Ubuntu 22.04+ 默认源已不含，得手动编译或换镜像） - VSCode 的
rogalmic.bash-debug扩展只是 UI 封装，它不会自动帮你装bashdb，也不会读取你的$PATH—— 必须在launch.json里显式写死路径，例如："bashdbPath": "/opt/homebrew/bin/bashdb" - 即使装了
bashdb，如果终端里运行bashdb --version报错，说明 VSCode 的集成终端根本没继承该命令，F5 必然卡在 “Cannot find debugger bashdb”
真正能落地的单步方案：bash -x + set -x
不用装任何插件，不改 launch.json，直接在脚本里加两行就能获得接近单步的效果：
- 在脚本开头插入：
set -x（开启执行追踪） - 在关键逻辑前后插入：
read -p "PAUSE: press Enter..."（手动暂停） - 保存后，在集成终端中运行：
bash ./script.sh（不加chmod +x也行） - 输出会逐行显示展开后的命令，比如
echo "Hello $USER"变成+ echo 'Hello alice'，变量、通配、子 shell 全部可见
比图形化调试更稳：不依赖插件状态、不卡在环境 PATH、不因 shebang 写错就静默失败。
Code Runner 或右键 Run Code 为什么不能用于调试
这类快捷执行方式默认走 /bin/sh，而 bash -x 是 Bash 特有功能，/bin/sh 执行会直接报错：sh: 1: set: Illegal option -x 或 sh: 1: read: not found。
- 如果你非要用 Code Runner，请修改其配置：
"shellscript": "bash -x -c 'cd $dir && $fileName'" - 但这样无法传参、无法暂停、输出混在一堆 shell 启动信息里，可读性差
- 更糟的是：一旦脚本里用了
[[ ]]、source ~/.bashrc或数组，/bin/sh直接语法错误，你连第一行都看不到
容易被忽略的关键细节
就算你配好了 bashdb 和 launch.json，以下三点仍常导致“看起来在调试，实际没生效”：
- 脚本首行
#!/usr/bin/env bash前有空格或 BOM ——bashdb会跳过 shebang，回退到/bin/sh解释，立刻崩 - VSCode 集成终端启动的是 non-login shell，而你脚本里
source ~/.zshrc依赖 login shell 加载的 alias 或函数 —— 运行结果和终端里直接敲bash script.sh不一致 -
set -x输出太密，关键变量值被淹没；别硬扛，加echo "DEBUG: count=$count"手动打点，比依赖自动展开更可控
