如何解决VS Code对包含合法PostgreSQL指令的SQL文件误报语法错误问题

报错原因 #

当前VS Code使用的是通用标准SQL语法校验规则，\connect属于PostgreSQL的psql客户端专属元命令，不属于标准SQL语法范畴，因此默认解析器会判定为语法错误。

常规解决步骤 #

1. 安装VS Code官方PostgreSQL语言扩展，替换默认的通用SQL语法解析器
2. 按需配置语法关联规则：

• 单文件生效：打开目标init.sql文件，点击右下角状态栏的「SQL」语言标识，在弹出的语言选择列表中选择「PostgreSQL」即可
• 全局/指定文件自动生效：打开VS Code的settings.json配置文件，添加以下规则：

"files.associations": {
    // 所有.sql后缀文件都用PostgreSQL语法解析，不需要可删除该行
    "*.sql": "postgres",
    // 仅init.sql文件使用PostgreSQL语法解析
    "init.sql": "postgres"
}

第三方Lint工具适配 #

如果安装了SQLFluff等自定义SQL校验工具，还需要修改工具配置文件，指定PG方言并开启元命令解析支持：

[core]
dialect = postgres
no_parse_commands = False

修改完成后重启Lint服务即可消除报错。

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