如何用dbt-formatter在VS Code中批量格式化SQL脚本？

方法一：批量打开文件后统一格式化 #

• 打开VS Code，使用快捷键Ctrl+Shift+F（Windows/Linux）或Cmd+Shift+F（Mac）搜索项目内所有.sql文件
• 全选搜索结果中的所有文件（Ctrl+A/Cmd+A），右键选择「打开选中的文件」
• 等所有文件加载完成后，按Ctrl+K Ctrl+F（Windows/Linux）或Cmd+K Cmd+F（Mac）触发全局格式化，最后按Ctrl+Shift+S（Windows/Linux）或Cmd+Shift+S（Mac）批量保存所有修改

方法二：修正VS Code批量格式化任务配置 #

之前的任务无效大概率是配置错误，以下是可直接复用的tasks.json配置：

1. 按Ctrl+Shift+B打开任务面板，选择「创建tasks.json文件」，选「其他」模板
2. 将默认内容替换为：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "批量格式化SQL文件",
      "type": "shell",
      "command": "for file in $(find . -name '*.sql' -type f); do code --format \"$file\"; done",
      "problemMatcher": [],
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

3. 保存后按Ctrl+Shift+B执行任务即可

注意：确保VS Code的code命令已加入系统PATH，可在终端输入code --version验证是否生效

方法三：使用dbt-formatter CLI批量处理（如果支持） #

如果你的dbt-formatter扩展提供CLI工具，可通过脚本批量遍历文件：

1. 创建shell脚本format_all_sql.sh：

#!/bin/bash
# 遍历当前目录及子目录下所有.sql文件并格式化
find . -name "*.sql" -type f | while read -r file; do
  dbt-formatter format "$file"
done

2. 给脚本添加执行权限：chmod +x format_all_sql.sh
3. 在终端运行脚本：./format_all_sql.sh

前置配置检查（解决之前工具失效问题） #

确保dbt-formatter是SQL文件的默认格式化工具：

• 打开VS Code设置（Ctrl+,/Cmd+,），搜索Default Formatter
• 找到「[sql] Default Formatter」选项，选择dbt-formatter对应的扩展（通常ID为innoverio.vscode-dbt-formatter）

内容的提问来源于stack exchange，提问作者Babatunde