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

20

查看详情

• 在行号左侧灰色区域单击设断点（红点），支持条件断点（右键 → 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% 的低级错误。