直接执行CREATE INDEX或ALTER TABLE添加索引是最可靠方式；需确保用户权限、表存在、索引名唯一、字段准确；复合索引须遵循最左前缀原则，范围查询字段应置右；添加前须清理重复数据，避免ERROR 1062；冗余索引会增加写入开销。
直接执行 CREATE INDEX 或 ALTER TABLE ... ADD INDEX 是最可靠、最通用的方式，PHP 本身不提供“建索引函数”，所有操作都依赖数据库驱动（PDO / MySQLi）执行原生 SQL。
用 PDO 执行 CREATE INDEX 创建普通索引
这是最常用、兼容性最好的方式。注意：必须确保连接用户有 INDEX 权限，且表已存在。
-
CREATE INDEX不能用于主键或唯一约束字段——它们已有隐式索引，重复创建会报错SQLSTATE[HY000]: General error: 1061 Duplicate key name - 索引名必须全局唯一（同一库内），建议按
idx_{table}_{col}命名，比如idx_users_email - 字段名要与表结构完全一致，大小写敏感取决于 MySQL 的
lower_case_table_names设置 - 示例语句：
$pdo->exec("CREATE INDEX idx_users_status ON users(status)");
用 ALTER TABLE 添加唯一索引（防重复插入）
当字段需强制唯一（如 email、order_no），应优先用唯一索引而非应用层校验——它能原子性拦截重复，避免竞态条件。
- 添加前必须清理重复数据，否则
ALTER TABLE会失败并提示ERROR 1062 (23000): Duplicate entry - 可先查重：
SELECT email, COUNT(*) FROM users GROUP BY email HAVING COUNT(*) > 1; - 添加语句：
$pdo->exec("ALTER TABLE users ADD UNIQUE INDEX uk_users_email (email)"); - PHP 中捕获冲突：检查
PDOException->getCode()是否为'23000'，再匹配Duplicate entry字符串
复合索引要注意最左前缀和范围查询顺序
WHERE 中多个条件共存时，单列索引效果往往不如合理设计的复合索引，但顺序错了就等于没建。
立即学习“PHP免费学习笔记（深入）”；
- 假设查询是
WHERE city = ? AND age > ? AND status = ?，推荐索引为(city, status, age)，而非(city, age, status) - 因为
age > ?是范围查询，它之后的字段（status）无法走索引；把等值条件字段放前面，范围字段放最后 - 验证是否生效：用
EXPLAIN SELECT ...查看key和Extra列，确认type是ref或range，且Extra不含Using filesort或Using temporary - 不要为
(a,b)和(a)同时建两个索引——前者已覆盖后者，冗余索引会拖慢写入
Doctrine ORM 用 Attributes 定义索引（非注解）
如果你用 Doctrine 2.11+，别再往 #[ORM\Table] 里塞 indexes 参数——它已被移除，必须用独立的 #[ORM\Index] Attribute。
- 每个索引一个
#[ORM\Index]，必须直接写在实体类上方，不能嵌套 - 多字段复合索引写法：
columns: ['user_id', 'status'] - 条件索引（Partial Index）支持 WHERE 子句：
options: ['where' => "status = 'active'"]，仅对满足条件的行建索引，节省空间 - 生成迁移前务必运行
php bin/console doctrine:migrations:diff，确认输出中包含CREATE INDEX而非报错
真正容易被忽略的是索引维护成本：每新增一条记录，MySQL 都要更新所有相关索引树。高频写入表（如日志、消息队列）加索引要格外谨慎，宁可加在查询端做缓存，也不要盲目堆索引。
