一、环境准备

  1. 安装VSCode

  2. Shell解释器配置

    • Linux/macOS：默认支持Bash，无需额外操作。

    • Windows：安装Git for Windows，使用其内置的bash.exe（路径如C:\Git\bin\bash.exe）。

二、核心插件安装

插件名称

功能说明

安装方式

Bash Debug

支持断点调试与变量监视

VSCode扩展市场搜索安装

ShellCheck

静态语法检查与错误提示

必装插件，支持实时检测

shell-format

代码格式化（依赖shfmt工具）

需额外下载shfmt

Code Runner

一键运行脚本（快捷键Ctrl+Alt+N）

支持多语言快速执行

三、配置调试功能

  1. 创建调试配置文件 在项目根目录新建.vscode/launch.json，内容如下：

    {
  "version": "0.2.0",
  "configurations": [
    {
      "type": "bashdb",
      "request": "launch",
      "name": "Bash Debug",
      "program": "${file}",
      "cwd": "${workspaceFolder}",
      "env": {}
    }
  ]
}

  2. Shell-Format配置 在VSCode设置（settings.json）中添加：

    {
  "shellformat.path": "D:\\Tools\\shfmt.exe",  // 替换为实际路径
  "shellformat.flag": "-i 2 -sr -kp -ci"      // 缩进2空格，自动补全括号
}

四、脚本运行与调试

  1. 运行脚本

    • 方法1：右键文件选择Run Code（需Code Runner插件）。

    • 方法2：终端中执行./script.sh（需chmod +x script.sh权限）。

  2. 调试脚本

    • 设置断点后按F5启动调试，支持变量监视和单步执行。

    • Windows注意：若提示权限问题，需禁用SIP或使用管理员模式运行VSCode。

五、高级优化

  1. ShellCheck集成 在VSCode中实时显示警告（如未引用的变量），通过Ctrl+Shift+P运行ShellCheck: Lint active file。

  2. 代码片段补全 安装Shellman插件，输入if/case等关键词自动生成代码结构。

六、跨平台兼容性配置

系统

特殊配置项

参考来源

Windows

脚本首行声明解释器路径

示例：#!C:\Git\bin\bash

Linux

确保bashdb已安装：sudo apt-get install bashdb

附：学习资源推荐