VSCode 不支持 PL/pgSQL 单步调试，因 PostgreSQL 无标准化调试协议；pldebugger 已弃用且兼容性差；可行方案是 RAISE NOTICE 日志、函数拆分、临时表观察及必要时 gdb attach backend 进程。
VSCode 本身不支持对 PL/pgSQL 函数的单步调试——它没有内置的 PL/pgSQL 解释器或调试协议适配器，无法像调试 C 或 Python 那样在 main() 或 def 处下断点、查看变量、逐行执行。你看到的“PL/SQL Developer”或“Oracle SQL Developer”里的单步功能，底层依赖数据库服务端的调试接口（如 Oracle 的 DBMS_DEBUG），而 PostgreSQL 官方至今未提供等效的、标准化的、可被 VSCode 直接调用的调试服务。
为什么 pgAdmin / DBeaver 里也看不到单步按钮
这不是工具缺陷，而是 PostgreSQL 内核设计决定的：PL/pgSQL 是解释执行的，且调试能力长期被归为“非核心需求”。虽然存在第三方扩展（如 pldebugger），但它：
- 仅支持 PostgreSQL 14 及更早版本（15+ 已移除官方维护）
- 必须手动编译安装，且与现代 SSL、JIT、动态加载机制存在兼容性问题
- 依赖
gdb在服务端进程内注入，实际是“attach 到 backend 进程 + patch 指令流”，不是语言级调试 - VSCode 的
cppdbg或lldb配置根本识别不了 PL/pgSQL 的源码映射
替代方案：用日志 + 小函数拆解 + backend attach 模拟单步
真正可行的调试路径不是“单步”，而是“分段验证 + 状态快照”：
- 在 PL/pgSQL 函数中插入
RAISE NOTICE 'step 3, val = %', my_var;，配合psql -v ON_ERROR_STOP=1 -f script.sql观察输出 - 把长函数拆成多个小
CREATE OR REPLACE FUNCTION，每个只做一件事，单独测试输入输出 - 当需要观察运行时状态（比如某条
UPDATE执行后临时表内容），改用CREATE TEMP TABLE AS SELECT ...+ 后续SELECT * FROM temp_table查看 - 若必须 inspect backend 进程内存（极少数场景），先用
SELECT pid, backend_start, state FROM pg_stat_activity WHERE application_name = 'my_app';找到 PID，再在 VSCode 中用cppdbg配置 attach 到该postgres进程（需确保它带--enable-debug编译），但此时你看到的是 C 层堆栈，不是 PL/pgSQL 行号
容易被忽略的关键限制
即使你成功启用过 pldebugger（例如在 PG 13 上），也会立刻遇到三个硬伤：
- 所有调试会话必须由超级用户发起，且目标函数必须用
SECURITY DEFINER或显式SET LOCAL plpgsql.debug = on（该 GUC 在 14 后废弃） - 无法调试嵌套在 SQL 函数（
LANGUAGE sql）或 C 函数中的 PL/pgSQL 逻辑 - VSCode 的
launch.json中无论怎么写"program"或"sourceMap"，都无法让编辑器把RAISE NOTICE日志行号和源文件位置对齐——因为 PL/pgSQL 源码不参与 C 编译流程，也不生成 DWARF 符号
所以别浪费时间找“VSCode PL/pgSQL 单步插件”。真要深度追踪逻辑，就老实用 RAISE 打桩，配合 pg_stat_statements 看执行计划，必要时切回 C 层用 gdb attach 到 backend 进程——这才是 PostgreSQL 生态里真实、稳定、可复现的调试方式。
