SQLFluff SQL 代码检查与格式化完整新手指南：5 分钟装完跑通自动修复
【免费下载链接】sqlfluffA modular SQL linter and auto-formatter with support for multiple dialects and templated code.项目地址: https://gitcode.com/GitHub_Trending/sq/sqlfluff
SQLFluff 是一款 SQL 代码检查器（linter）兼自动格式化工具，面向维护大量 SQL 脚本的数据开发者和数据工程师。它把 SQL 解析成语法树，再跑一套可勾选的规则包——就像一份能自动打勾的检查清单——找出风格、缩进、逗号、大小写等问题，并且大多数问题可以直接改写修复。支持 30 多种数据库方言，也兼容 Jinja、dbt 这类模板化代码。
它解决什么问题？
团队里的 SQL 文件写久了必然风格漂移：有人缩进用空格有人用制表符，逗号有人放行尾有人放行首，纯靠 review 盯不住，自己写正则检查又极易误报。SQLFluff 干的就是这件脏活：对整条 SQL 做真正的语法解析后，逐条规则核对并报告位置，能修的直接修。典型场景：仓库里几百个.sql没有任何规范，想在 CI 里强制统一风格，又不想引入重量级工具链。
3 分钟完成安装与首次运行
在 Python 3.10+ 环境执行安装，然后随手造一个"脏"文件验证：
pip install sqlfluff echo " SELECT a + b FROM tbl; " > test.sql sqlfluff lint test.sql --dialect ansi输出是一组"规则码 | 行号 | 列号 | 说明"，例如L: 1 | P: 1 | LT01表示 SELECT 前多了一个空格。以后看结果先认规则码（LT 管布局、ST 管结构、AM 管歧义），再定位行列即可。如果打算通读源码，可先克隆仓库：git clone https://gitcode.com/GitHub_Trending/sq/sqlfluff。
一条命令自动修复 SQL 格式
lint 出结果后，绝大多数问题不需要人手工改。fix子命令就是"一键修复"：
sqlfluff fix test.sql --dialect ansi执行完 test.sql 的开头空白、双空格和结尾多余空白会被直接重写，文件以单个换行收尾。适用场景：团队刚定下风格规范，让工具先对全仓库跑一遍，人只看 diff 确认。
如果你只想确认 SQL 写没写错、不想动文件，换sqlfluff parse test.sql --dialect ansi，它会打印语法树，语法错误时会直接指出出错位置——排查模板渲染出来的 SQL 时特别顺手。
如何切换数据库方言
默认按 ansi 方言解析，但业务 SQL 几乎总有方言专属语法，切换有 3 种方式：
- 命令行加
--dialect bigquery，只对当次生效； - 在配置文件写
dialect = bigquery，对整个项目生效； - 运行
sqlfluff dialects查看完整支持列表再选。
Postgres、MySQL、Snowflake、BigQuery、T-SQL、SparkSQL 等 30 多种方言开箱可用。适用场景：一个数据仓库同时连 DuckDB 和 ClickHouse，按目录各自声明方言，用同一套规则检查即可。
如何让规则符合团队风格
规则可以像清单一样增删：配置里用rules指定启用哪些、exclude_rules排除哪些；某一行确实有历史原因不合规，直接写-- noqa: LT01就地豁免。所有默认值集中在核心默认配置文件，在项目根目录放一份自己的.sqlfluff或pyproject.toml就能覆盖。适用场景：团队决定"关键字不用大写、缩进 4 空格"，改一处配置，全团队代码跟着对齐。
如果你的 SQL 里大量使用 Jinja 模板或 dbt 模型，还要配置 templater；dbt 项目有专门插件，见 dbt 模板插件。
想读源码从哪里入手
核心代码都在src/sqlfluff/下，日常阅读基本绕不开这几条路径：
src/sqlfluff/core/linter/—— lint 主流程，从读文件到出报告src/sqlfluff/dialects/—— 各方言的语法树定义- src/sqlfluff/rules/ —— 规则包实现，按 layout、aliasing、references 等分目录
test/rules/—— 每条规则的 YAML 测试用例，照抄一份就是新规则的脚手架
更多命令参数与规则细节可查官方文档；项目每月发一个版本，遇到怪行为先看 release notes 和规则参考，社区讨论也非常活跃。
【免费下载链接】sqlfluffA modular SQL linter and auto-formatter with support for multiple dialects and templated code.项目地址: https://gitcode.com/GitHub_Trending/sq/sqlfluff
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
