隐藏索引只能在创建时通过 hidden: true 指定，不可事后隐藏；取消隐藏需用 unhideIndex() 或 collMod 命令，不能直接修改已有索引的 hidden 属性，且隐藏索引仍占用资源并持续更新。

隐藏索引不能“恢复”，只能取消隐藏；创建时必须显式指定 hidden: true，否则默认可见。

如何创建隐藏索引

隐藏索引不是通过后期命令“设为隐藏”，而是在创建时就带上 hidden: true 选项。MongoDB 不支持对已存在的普通索引直接加隐藏属性——你必须删掉再重建，或用 collMod 修改（仅限部分场景，见下文）。

• 正确方式：使用 db.collection.createIndex() 显式声明 hidden: true
• 错误做法：先建普通索引，再试图用 hideIndex() 隐藏 —— 这个方法 不存在，MongoDB 没有 hideIndex() 辅助方法
• 示例：db.restaurants.createIndex({ borough: 1, ratings: 1 }, { hidden: true })
• 注意：hidden 是布尔值，不能写成字符串 "true"，否则会被忽略

如何取消隐藏（即“恢复”索引）

所谓“恢复”，实际是调用 unhideIndex() 或等效的 collMod 命令，让查询规划器重新考虑该索引。它不会重建索引，只是切换可见性状态。

• 推荐用 db.collection.unhideIndex()，更简洁：db.restaurants.unhideIndex("borough_1_ratings_1")
• 也可用底层命令：db.runCommand({ collMod: "restaurants", index: { name: "borough_1_ratings_1", hidden: false } })
• 参数支持索引名（字符串）或索引规范（文档），但文本索引必须用名称，不能用键模式
• 如果索引本来就没隐藏，执行 unhideIndex() 是 no-op，不报错，但会生成一条空 oplog 条目

为什么不能直接修改已有索引的 hidden 属性

MongoDB 的索引元数据是只读的（除少数例外），hidden 属于不可原地修改的字段。你无法像改 expireAfterSeconds 那样直接更新它 —— collMod 的 index 选项里虽有 hidden: <boolean></boolean> 字段，但它只对**已标记为 hidden 的索引生效**，对普通索引不起作用。

• 尝试对未隐藏索引执行 collMod 设 hidden: true 会报错："cannot find index ... for ns ..."
• 这意味着：想隐藏一个已有索引，唯一安全做法是先 dropIndex()，再用 createIndex(..., { hidden: true }) 重建
• 重建期间索引不可用，生产环境需评估查询性能影响

容易被忽略的关键点

隐藏索引不是删除，它仍占用磁盘和内存，仍随写操作更新 —— 只是查询规划器视而不见。很多人误以为“隐藏=停用=省资源”，其实完全相反。

• getIndexes() 仍会返回隐藏索引，但带 "hidden": true 字段
• 隐藏索引的 $indexStats 依然在采集，但因不参与查询，统计值可能长期无变化
• 权限要求没变：执行 unhideIndex() 仍需 collMod 权限（如 dbAdmin 角色）
• Atlas 全支持，但本地 MongoDB Community 版本需 ≥ 4.4（hidden 选项自 4.4 引入）