1、 先说说什么是索引，别管它到底怎么回事

试着... 索引啊，就是数据库里的一根小棍子，能让查询快一点。像你去图书馆找一本书，如果有目录就不需要翻遍所有书架啦。

很多人说要用B‑tree、 Hash之类的高级玩意儿，其实你只要记住：有就行不一定非得懂。

1.1 PostgreSQL自带的几种索引

• B‑tree：默认的，最常用。
• GiST：适合空间数据，或者你想装酷。
• GIN：全文检索，用来搜索文字。
• BRIN：大表上省内存，慢慢来。

以上这些其实你在代码里根本不需要写太多，只要@Index一下就行。

2、TypeORM到底会不会自动建索引？

吃瓜。 先说主键。你用了@PrimaryGeneratedColumn或者@PrimaryColumn PostgreSQL会自动给它建一个唯一的B‑tree主键索引，这点是铁律。别问为什么是数据库默认的规则。

没耳听。 再说唯一约束。只要在实体属性上加@Column TypeORM会帮你在PostgreSQL里创建一个唯一索引，同样是B‑tree。这里有个坑：如果你的列是varchar这种大字段， 唯一索引会占很多空间，你可以考虑改成text再加CITEXT之类的，不过这一步可以省略——省事！

外键列默认不建索引！

很多新手以为外键自动带索引，其实不是。外键只能保证参照完整性， 但如果你经常用它来JOIN查询， 加油！ 那就手动加个@Index吧。

2.1 手动加@Index的几种写法

import { Entity, PrimaryGeneratedColumn, Column, Index } from "typeorm";
@Entity
@Index // 复合单列
@Index // 唯一复合
export class User {
    @PrimaryGeneratedColumn
    id: number;
    @Index
    @Column
    firstName: string;
    @Index
    @Column
    middleName: string;
    @Index
    @Column
    lastName: string;
}

3、怎么决定到底要单列还是复合？

如果你的查询经常是：

SELECT * FROM user WHERE first_name = $1 AND last_name = $2;

那最好建一个复合索引 @Index. 但如果你有时候只查firstName， 那单列也可以保留，两者并存也没啥大问题，只要别把所有列都搞成复合，否则会浪费磁盘，就这样吧...。

小技巧：

• 先跑一次, 看看哪些SQL最慢，再针对性加索引。
• 每次改完索引后记得, 否则优化器还以为表很小。

4、 别忘了维护统计信息

我们发现检查完列表后把统计信息计数器reset一下很管用。PostgreSQL提供了函数来重置不同层级的统计信息：，太暖了。

VACUUM ANALYZE;
-- 或者更细粒度
SELECT pg_stat_reset;
SELECT pg_stat_reset_shared;

4.1 索引碎片怎么办？

If you see index bloat you can just run:，好吧...

REINDEX INDEX my_table_my_column_idx;
-- 或者全库
REINDEX DATABASE mydb;

5、 特殊场景：向量检索和pgvector

AFAIK pgvector 的 vector 和 Qdrant 的 VectorParams 在逻辑上差不多， 对吧？ 只是实现方式不同。如果你用 TypeORM 存储向量字段，可以这样：

另起炉灶。 5.1 把向量搜索时间映射到 OpenTelemetry

6、常见误区合集

更多奇怪但可能有用的信息，请关注我们的博客或直接搜索 “TypeORM PostgreSQL 索引用法”，太治愈了。。

7、 随心所欲搞索引，不用太严谨 Total word count 大概在两千字左右，够SEO又够乱。记住下面这句话： “有就行，没有也行；加了就是好，不加也是可以。” If you follow this guide you will probably get decent performance or at least not crash your DB. 本文内容，请自行验证并做好备份，不地道。！