sqlfluff插件不生效，首要确认本地sqlfluff cli是否安装并加入path；若终端运行sqlfluff --version报错，则需用pipx安装或检查venv及path配置，并确保vscode通过code .启动以继承环境变量。
SQLFluff 插件装了但不生效？先确认 sqlfluff CLI 是否在 PATH 中
VSCode 的 SQLFluff 扩展（如 sqlfluff-vscode）本身不带执行引擎，它依赖你本地安装的 Python 包 sqlfluff CLI。如果编辑器里没反应、右键无“Fix”选项、保存也不格式化，大概率是 VSCode 找不到 sqlfluff 命令。
验证方式：在终端运行 sqlfluff --version。若报 command not found，说明没装或不在 PATH。
- 推荐用
pipx install sqlfluff（隔离环境、PATH 自动配置） - 若用
pip install sqlfluff，注意是否在当前 Python 环境（比如 venv 激活状态），且该环境的bin/（macOS/Linux）或Scripts\（Windows）已加入系统 PATH - VSCode 启动方式影响 PATH：从命令行
code .启动能继承 shell 环境；从桌面图标启动可能读不到 shell 的 PATH，此时需在 VSCode 设置中显式指定"sqlfluff.executablePath"
如何让保存时自动修复 SQL？关键靠 editor.codeActionsOnSave + sqlfluff 配置
SQLFluff 默认只做 lint（报错），不自动修复；要“保存即修复”，必须手动开启 code action 并确保规则支持修复（不是所有规则都可 auto-fix，比如 L051 就不行）。
在 VSCode 工作区设置（.vscode/settings.json）中添加：
{
"editor.codeActionsOnSave": {
"source.fixAll.sqlfluff": true
},
"sqlfluff.rules": ["L001", "L003", "L010", "L029"],
"sqlfluff.dialect": "postgres"
}
-
"source.fixAll.sqlfluff": true是触发自动修复的开关，缺它就只是标红不修 -
"sqlfluff.rules"建议显式列出你信任且支持修复的规则（查文档看哪些 rule 标有 ✅ Fix），避免启用L044这类高风险重写规则导致误改逻辑 -
"sqlfluff.dialect"必须设（如bigquery、redshift），否则sqlfluff会 fallback 到ansi，解析失败率陡增
为什么 SQL 文件没语法高亮或诊断？检查文件关联和语言模式
VSCode 不会默认把 .sql 当作 SQLFluff 管理的语言——它可能被识别为 plaintext 或其它扩展（如 mssql 插件抢占）。
- 打开一个 .sql 文件，看右下角语言模式（如显示 “Plain Text”），点击它 → 选择 “Configure File Association for '.sql'” → 设为
sql - 确保没有其它 SQL 相关插件（如
vscode-sql-server）禁用了 diagnostics；可在命令面板运行Developer: Toggle Developer Tools，看 Console 是否报sqlfluff初始化失败 - 若用
.sql.j2（Jinja 模板），需额外配置"sqlfluff.templater": "jinja"，否则直接报解析错误
修复后缩进混乱或关键字大小写不对？调整 .sqlfluff 配置文件更可靠
VSCode 设置只能控制开关和基础规则，真正决定“怎么修”的是项目级的 .sqlfluff（TOML）或 setup.cfg。比如 L010（keyword case）默认转大写，但团队约定小写，就得在配置里覆盖：
[sqlfluff] dialect = postgres [sqlfluff:rules:L010] capitalisation_policy = lower
- VSCode 的
sqlfluff.rules设置无法覆盖单条规则参数，必须用配置文件 - 缩进行为由
L003控制：indent_unit = " "（两个空格）比tab更稳定，尤其跨平台协作时 - 配置文件必须放在工作区根目录（或通过
sqlfluff.config_path指定），VSCode 插件才会读取
最常被忽略的是：VSCode 插件不会实时监听 .sqlfluff 文件变更，改完配置需重启窗口或重载窗口（Developer: Reload Window）才生效。
