VSCode 是编写调试 Shell 脚本的高效工具，需安装 ShellCheck 和 Bash Debug 扩展，配置 launch.json，设断点、查变量、用调试控制台，并注意 shebang、权限、路径及 bash 版本问题。
VSCode 是编写和调试 Shell 脚本的轻量高效选择，关键在于装对扩展、配好环境、用对调试方式——不用开终端来回切，也能像写 Python 那样单步断点、看变量、查错误。
安装必要扩展
VSCode 本身不内置 Shell 调试能力，需靠扩展补足：
- ShellCheck：实时语法检查和风格建议（自动标出未引号变量、未定义变量等）
- Bash Debug（推荐）或 Shell Launcher：提供真正的断点调试支持（注意：Bash Debug 依赖系统 bash 和 node.js）
- 可选：Shellman（快速生成 shebang、函数模板）、Bracket Pair Colorizer（括号高亮，对嵌套 if/for 很有用）
配置 Bash Debug（以 Ubuntu/macOS 为例）
确保系统已安装 bash（通常默认有），再在 VSCode 中操作：
- 打开脚本文件（如 deploy.sh），点击左侧边栏「运行和调试」图标（Ctrl+Shift+D）
- 点「创建 launch.json 文件」→ 选择环境为 Bash
- VSCode 会生成 .vscode/launch.json，确认其中
"type": "bash"和"request": "launch"存在 - 关键项可手动加：
"args": ["arg1", "arg2"]（传参调试）、"env": {"DEBUG": "1"}（注入环境变量）
开始调试：断点 + 变量 + 控制台
调试不是只按 F5，重点在三件事：
高级Bash脚本编程指南 chm版
下载
这本书假定你没有任何关于脚本或一般程序的编程知识, 但是如果你具备相关的知识, 那么你将很容易就能够达到中高级的水平. . . 所有这些只是UNIX®浩瀚知识的一小部分. 你可以把本书作为教材, 自学手册, 或者是关于shell脚本技术的文档. 书中的练习和样例脚本中的注释将会与读者进行更好的互动, 但是最关键的前提是: 想真正学习脚本编程的唯一途径就是亲自动手编写脚本. 这本书也可作为教材来讲解一般的编程概念. 向伟大的中华民族的Linux用户致意! 我希望这本书能够帮助你们学习和理解L
- 在行号左侧灰色区域单击设断点（红点），支持条件断点（右键 → Edit Breakpoint → 输入
$1 == "prod"这类表达式） - F5 启动后，自动停在断点；F10 单步跳过，F11 单步进入函数；悬停变量名可看当前值（如
$PATH、${#arr[@]}） - 调试控制台（下方 Terminal 标签页里「DEBUG」子标签）可手动执行命令，比如
echo $PWD或set -x查看当前展开逻辑
常见问题速查
调试失败？大概率卡在这几个地方：
- 脚本没加
#!/bin/bash（或对应解释器路径），Bash Debug 无法识别类型 - 权限不足：保存后执行
chmod +x script.sh，否则调试时提示 “Permission denied” - 路径含空格或中文：launch.json 中
"program"字段务必用绝对路径，或改用"${file}"变量自动填充当前文件 - Mac 上 bash 版本太老（/bin/bash 是 v3.2）：用
brew install bash，然后把 launch.json 的"bashPath"指向/opt/homebrew/bin/bash
基本上就这些。写 Shell 不必忍受纯终端试错，VSCode 调试起来很顺手，关键是别漏掉 ShellCheck 的实时提示——它能帮你避开 80% 的低级错误。
