用 Sublime Text 编辑 PostgreSQL C 扩展需配置 PGXS 环境，遵循 ABI 规范；主文件含 PG_MODULE_MAGIC 和 palloc/pfree 内存管理；SQL 文件注册类型与函数；调试依赖 pg_regres、gdb 和日志。
用 C 语言为 PostgreSQL 编写扩展，不是“在 Sublime 中开发”，而是用 Sublime Text 作为编辑器辅助开发 PostgreSQL 的 C 扩展。Sublime 本身不参与编译、加载或执行，它只是个高效、轻量的代码编辑工具。关键在于正确配置开发环境、遵循 PostgreSQL 扩展的 ABI 规范，并通过 pg_config 和 make 构建流程完成编译安装。
环境准备与项目结构
确保已安装 PostgreSQL 开发包（如 postgresql-server-dev-15 或对应版本）和 pg_config 可执行文件在 $PATH 中。推荐项目结构如下：
-
my_ext/—— 项目根目录 -
my_ext/my_ext.c—— 主 C 源文件（含 PG_MODULE_MAGIC、函数定义、类型定义等） -
my_ext/my_ext.sql—— SQL 脚本（声明函数、类型、操作符等） -
my_ext/Makefile—— 使用 PGXS 自动生成的 Makefile 模板
用 Sublime 打开整个 my_ext/ 目录即可获得语法高亮（安装 “C” 和 “SQL” 插件）、跳转、多光标编辑等支持。可手动配置 Sublime 的构建系统，调用 make install 简化流程（非必需，但提升效率）。
编写安全的 C 函数（带参数校验与内存管理）
PostgreSQL C 函数必须严格遵守内存生命周期规则：所有返回给服务器的数据必须分配在当前内存上下文（如 CurrentMemoryContext），不可返回栈变量地址或静态局部变量（除非只读且全局有效）。示例：一个接收 text 并返回大写的自定义函数：
立即学习“C语言免费学习笔记（深入）”；
PG_FUNCTION_INFO_V1(upper_text);
Datum
upper_text(PG_FUNCTION_ARGS)
{
text *input = PG_GETARG_TEXT_PP(0); // 安全获取变长文本（支持 toast）
char *str = text_to_cstring(input);
char *upper_str = palloc(VARSIZE(input)); // 分配足够空间
for (int i = 0; str[i]; i++) {
upper_str[i] = toupper((unsigned char) str[i]);
}
upper_str[strlen(str)] = '\0';
text *result = cstring_to_text(upper_str);
pfree(str);
pfree(upper_str);
PG_RETURN_TEXT_P(result);
}
注意使用 PG_GETARG_* 宏而非直接解引用，使用 palloc/pfree 而非 malloc/free，返回前务必调用 PG_RETURN_* 宏。
定义新数据类型（基础类型 + 输入输出函数）
PostgreSQL 不允许直接在 C 中“声明类型”，而是通过 SQL 注册类型，并提供四个必需的 I/O 函数：输入（in）、输出（out）、接收（recv）、发送（send）。最常用的是 in 和 out。
-
my_type_in(cstring)：将字符串解析为内部表示（如int32或自定义 struct） -
my_type_out(my_type)：将内部值格式化为 C 字符串
在 my_ext.sql 中注册：
CREATE TYPE my_type;
CREATE FUNCTION my_type_in(cstring) RETURNS my_type
AS '$libdir/my_ext', 'my_type_in'
LANGUAGE C IMMUTABLE STRICT;
CREATE FUNCTION my_type_out(my_type) RETURNS cstring
AS '$libdir/my_ext', 'my_type_out'
LANGUAGE C IMMUTABLE STRICT;
CREATE TYPE my_type (
INPUT = my_type_in,
OUTPUT = my_type_out,
INTERNALLENGTH = 4,
ALIGNMENT = int4
);
类型内部长度、对齐方式需与 C 结构体匹配；若为变长类型，设 INTERNALLENGTH = -1 并实现 typmod 支持。
调试与验证技巧
C 扩展出错常导致 PostgreSQL 后端崩溃（segmentation fault），因此调试要谨慎：
- 先用
pg_regress写测试用例，在隔离环境中运行 - 启用
log_min_messages = debug5查看函数调用轨迹 - 用
gdb附加到postgres进程（需源码编译并保留 debug info） - 在函数开头加
ereport(DEBUG1, (errmsg("entering my_func")));快速定位执行点
每次修改 C 代码后，执行 make clean && make install，再在数据库中 CREATE EXTENSION my_ext CASCADE;（若已存在则先 DROP EXTENSION）。
基本上就这些。Sublime 是趁手的刀，PostgreSQL C 扩展是精密的钟表——重点不在编辑器，而在理解内存模型、ABI 约束和 SQL-C 协作机制。写得规范，跑得安稳。
