配置指南

项目本地开发时使用本地psql数据库

Created: 12/27/2025
Updated: 12/28/2025

写在前面

相信大伙在本地启动使用Supabase时经常会遇到一些网络连接问题导致的慢或者其他诡异问题,官方也是建议咱们在本地开发时连接本地psql数据库,提升开发效率

安装 PostgreSQL(Mac)

安装postgresql@16

访问 https://postgresapp.com/downloads.html 下载

下载,安装完成后

打开 Postgres.app-点击 "Initialize"

然后终端添加到 PATH:

echo 'export PATH="/Applications/Postgres.app/Contents/Versions/latest/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

创建数据库

createdb shipany_nanobanana_dev

配置.env.development

# database
DATABASE_URL = "postgresql://你的电脑名@localhost:5432/shipany_nanobanana_dev"
DATABASE_PROVIDER = "postgresql"
DB_SINGLETON_ENABLED = "true"

此时,数据库已配置好,请返回项目快速上手图文教程 继续操作。

测试发现:响应快很多,比魔法+Supabase快,提升开发效率

安装 PostgreSQL 官方安装器(Windwos)

打开:https://www.postgresql.org/download/windows/

下载 EDB 安装器

运行安装,记住设置的密码

验证安装成功,打开 PowerShell 或 CMD

psql --version

如果能显示版本号,就说明好了,PATH也自动添加了。

安装后操作

打开 PowerShell 或 CMD
创建数据库:

shipany_nanobanana_dev 为数据库名称,可以自行修改

createdb -U postgres shipany_nanobanana_dev

配置 .env.development:

DATABASE_URL = "postgresql://postgres:你的密码@localhost:5432/shipany_nanobanana_dev"

此时,数据库已配置好,请返回项目快速上手图文教程 继续操作