createdb

创建 PostgreSQL 数据库

补充说明

createdb 是 CREATE DATABASE 的命令行封装，适合脚本和初始化流程。它只创建空库，不负责建角色、扩展或 schema。

常用示例

createdb appdb
createdb -h 127.0.0.1 -U postgres -O app appdb
createdb -T template0 -E UTF8 --lc-collate=C --lc-ctype=C appdb
createdb -O app -T app_template appdb
createdb --if-not-exists appdb

易错点与排错

• 需要 CREATEDB 权限或超级用户；普通业务账号通常没有。
• 用 template1 建库时，其他连接会阻塞创建；优先 -T template0。
• 集群的 locale/encoding 不兼容时不能直接套用；template0 才能改编码和排序规则。
• 库名不加引号会被折叠成小写；大写或特殊字符需要双引号。
• 目标库已存在会报错；脚本里用 --if-not-exists 或先查询 pg_database。
• 创建后不会自动安装扩展；CREATE EXTENSION 要在目标库内执行。
• 连接参数和 psql 一致；-h 决定走 TCP 还是 Unix socket。

相关命令

• dropdb — 删除数据库
• psql — 连接并初始化库
• pg_dump — 备份数据库