TypeORM能否将数据库架构与模型/实体文件分离？

当然可以实现你想要的模式——完全用迁移（migrations）管理数据库架构，实体（Entities）仅作为数据访问的模型，不参与架构定义。以下是具体的实现步骤：

1. 禁用TypeORM的自动架构同步功能 #

首先必须关闭TypeORM的自动同步机制，避免实体元数据意外修改数据库结构。在TypeORM的配置文件（如data-source.ts或ormconfig.json）中设置：

// data-source.ts示例
import { DataSource } from "typeorm"

export const AppDataSource = new DataSource({
    type: "mysql",
    host: "localhost",
    port: 3306,
    username: "test",
    password: "test",
    database: "test",
    entities: ["./src/entities/**/*.ts"],
    migrations: ["./src/migrations/**/*.ts"],
    synchronize: false, // 核心：禁用自动同步
    dropSchema: false, // 禁止自动删除表
    logging: false,
})

2. 创建仅用于数据访问的实体 #

实体类只需要映射数据库中已存在的字段，无需定义任何架构相关的元数据（比如列类型、长度、约束等）。你可以仅使用基础的装饰器来建立字段与数据库列的映射：

// src/entities/User.ts
import { Entity, Column, PrimaryGeneratedColumn } from "typeorm"

@Entity() // 仅标记为实体，不指定额外架构参数
export class User {
    @PrimaryGeneratedColumn() // 对应数据库的自增主键列
    id: number

    @Column({ name: "user_name" }) // 仅指定列名（如果和属性名不一致）
    userName: string

    @Column() // 直接映射同名列，无需定义类型等
    email: string

    @Column()
    created_at: Date
}

这里的@Column装饰器仅用于告诉TypeORM属性对应数据库的哪一列，所有列的类型、约束等都已经由迁移文件定义，实体中不需要额外配置。

3. 完全手动维护迁移文件 #

所有数据库架构变更都通过手动创建和编写迁移文件来完成，不要使用typeorm schema:generate命令（该命令会基于实体元数据生成迁移）。正确的流程是：

• 执行typeorm migration:create src/migrations/CreateUsersTable创建空迁移文件
• 在迁移文件的up方法中编写创建/修改表的SQL（或TypeORM的SchemaBuilder API），比如：

// src/migrations/1690000000000-CreateUsersTable.ts
import { MigrationInterface, QueryRunner } from "typeorm"

export class CreateUsersTable1690000000000 implements MigrationInterface {
    public async up(queryRunner: QueryRunner): Promise<void> {
        await queryRunner.query(`
            CREATE TABLE users (
                id INT AUTO_INCREMENT PRIMARY KEY,
                user_name VARCHAR(255) NOT NULL,
                email VARCHAR(255) NOT NULL UNIQUE,
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
            )
        `)
    }

    public async down(queryRunner: QueryRunner): Promise<void> {
        await queryRunner.query(`DROP TABLE users`)
    }
}

• 执行typeorm migration:run来应用迁移，完成架构变更。

注意事项 #

• 实体的属性名称需与数据库列名保持一致（或通过@Column({name: ...})显式指定），否则会出现映射错误。
• 不要在实体装饰器中添加任何会影响架构的参数（如@Column({type: 'varchar', length: 255})），虽然关闭同步后这些参数不会生效，但会造成混淆，建议仅保留必要的映射配置。
• 所有架构变更必须通过迁移文件执行，避免直接修改数据库，保证环境间的架构一致性。

内容的提问来源于stack exchange，提问作者Mike Purcell