VSCode中Shell脚本问题可通过五步解决：一、安装启用ShellCheck扩展实现语法检查；二、配置Shell解释器路径；三、创建launch.json调试配置；四、用Code Runner快速执行；五、启用Bash Debug扩展支持断点调试。
如果您在VSCode中编写Shell脚本时遇到语法高亮异常、代码补全失效或调试无法启动等问题，则可能是由于扩展配置缺失、解释器路径未指定或调试环境未正确初始化。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用ShellCheck扩展
ShellCheck是一个静态分析工具，用于检测Shell脚本中的常见错误和潜在问题。VSCode通过该扩展实现实时语法检查与错误提示。
1、打开VSCode左侧活动栏，点击扩展图标（四个方块组成的图标）。
2、在搜索框中输入ShellCheck，选择由koalaman发布的官方扩展。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
4、新建一个以.sh为后缀的文件，输入if [ -z "$VAR" ]; then echo "empty"; fi，观察是否出现波浪线提示及悬停信息。
二、配置默认Shell解释器路径
VSCode调试器需明确知道系统中Shell解释器的实际位置，否则launch.json中的program字段将无法定位执行入口。
1、在终端中执行which bash或which zsh，记录返回的完整路径，例如/bin/zsh。
2、在VSCode中打开项目根目录，按下Cmd+Shift+P调出命令面板，输入并选择“Shell Script: Configure Shell Interpreter”。
3、从下拉列表中选择已识别的Shell路径，或手动输入上一步获取的路径。
三、创建并配置launch.json调试配置
launch.json定义了VSCode如何启动Shell脚本调试会话，包括参数传递、工作目录和环境变量等关键设置。
1、在VSCode中打开目标Shell脚本文件。
2、点击顶部菜单栏“运行”→“添加配置”，选择Shell Script环境。
3、在生成的.vscode/launch.json中，确认configurations数组内包含如下字段："program": "${file}"、"args": []、"env": {}。
4、如需传入参数，在args中添加字符串数组，例如["--verbose", "/tmp/test.txt"]。
四、使用Code Runner插件快速执行
Code Runner提供一键运行功能，适用于无需断点调试的快速验证场景，支持自定义执行命令与输出位置。
1、在扩展市场中搜索并安装Code Runner（作者：Jun Han）。
2、右键编辑器中打开的.sh文件，选择“Run Code”，或使用快捷键Cmd+Alt+N。
3、查看底部终端面板输出结果；若报错“Permission denied”，则先执行chmod +x ${file}赋予执行权限。
4、如需修改默认执行命令，在设置中搜索code-runner.executorMap，找到shell项，将其值改为bash -x -c 'source \"$fullFileName\"'以启用追踪模式。
五、启用Bash Debug扩展进行断点调试
Bash Debug扩展基于bashdb实现GDB风格的交互式调试能力，支持单步执行、变量监视与条件断点等功能。
1、安装扩展Bash Debug（作者：rogalmic）。
2、确保系统已安装bashdb：在终端运行brew install bashdb（macOS）或sudo apt install bashdb（Ubuntu）。
3、在launch.json中添加新配置，设置"type": "bash"、"request": "launch"、"path": "${file}"。
4、在脚本行号左侧灰色区域点击设置断点，按F5启动调试，使用F10单步跳过、F11单步进入。
