Prisma 安装与项目初始化

前置条件

开始之前确保你有：

• Node.js v16.13.0 或更高版本——推荐 v18 LTS 或 v20 LTS
• 一个包管理器（npm / pnpm / yarn / bun，任选其一）
• 一个你能连接上的数据库（PostgreSQL、MySQL、SQLite 等）

快速开始的两种姿势

Prisma 有两条主要路径：从零开始建模（推荐新项目）和 接入已有数据库（用 db pull 内省）。本节走第一条。

步骤一：创建 TypeScript 项目

先创建一个新目录并初始化：

mkdir hello-prisma
cd hello-prisma
npm init -y

安装 TypeScript、ts-node 和 Prisma CLI：

npm install typescript ts-node @types/node --save-dev
npm install @prisma/client
npm install prisma --save-dev

初始化 TypeScript 配置：

npx tsc --init

这会在项目根目录生成一个 tsconfig.json。如果你用的是 pnpm/yarn/bun，把上面的 npm 换成对应命令即可（pnpm add -D prisma、bun add prisma -d 等）。

步骤二：初始化 Prisma

执行 Prisma CLI 的初始化命令：

npx prisma init --datasource-provider postgresql

如果用 SQLite：

npx prisma init --datasource-provider sqlite

这条命令做了两件事：

1. 在项目根目录下创建 prisma/ 目录，并生成一个初始的 schema.prisma 文件
2. 创建一个 .env 文件，里面有一个占位的 DATABASE_URL 环境变量

初始化后的目录结构大概是：

hello-prisma/
├── node_modules/
├── prisma/
│   └── schema.prisma
├── .env
├── package.json
└── tsconfig.json

步骤三：配置数据库连接

打开 .env 文件，把占位的 DATABASE_URL 换成你真实的数据库连接字符串：

PostgreSQL 示例：

DATABASE_URL="postgresql://postgres:password@localhost:5432/mydb?schema=public"

MySQL 示例：

DATABASE_URL="mysql://root:password@localhost:3306/mydb"

SQLite 示例（文件路径）：

DATABASE_URL="file:./dev.db"

.env 文件默认被 .gitignore 忽略，不要手动把它提交到 Git——里面可能含数据库密码。

下一步

现在你的项目里已经有了 schema.prisma 和数据库连接。接下来该在 Schema 里定义数据模型了——参见 第一个 Schema。