Nginx 的 index 指令不继承不叠加，仅由最匹配的 location 块中最近定义的生效，遵循“就近覆盖”原则，且只对以斜杠结尾的请求起作用。
Nginx 的 index 指令在多级 location 块中不继承、不叠加，而是由**最匹配的 location 块中最近定义的 index 指令生效**——也就是说，它遵循“就近覆盖”原则，且只对当前 location 作用域内以斜杠结尾的请求（如 /path/）起作用。
index 指令的作用范围仅限于当前 location
index 不是全局配置，也不向下传递。即使父 location 定义了 index index.html，子 location 若未显式声明，就**不会自动使用父级的值**；反之，子 location 定义了 index index.php，则该 location 下所有以 / 结尾的请求都优先尝试 index.php，完全忽略父级设置。
- 根 location 中设
index a.html，不影响location /api/内部行为 -
location /static/中设index b.css，只对/static/这类请求生效，不干扰/static/js/（除非后者也有自己的 location 块并定义了 index） - 若某 location 未配置
index，且请求路径以/结尾，Nginx 默认不自动查找任何索引文件，直接返回 403 或 404（取决于是否开启autoindex）
嵌套 location 中的匹配优先级决定 index 生效位置
Nginx 不支持真正意义上的“嵌套 location”，但可通过前缀匹配形成逻辑层级。最终生效的 index 取决于 URI 最终落入哪个 location 块——也就是最长前缀匹配或正则匹配成功的位置。
-
location /app/ { index app.html; }和location /app/api/ { index api.php; }同时存在时：
→ 请求/app/匹配前者，用app.html
→ 请求/app/api/匹配后者，用api.php - 正则 location（
~,~*）优先级高于前缀 location，若正则块中定义了index，即使路径也符合某个前缀 location，仍以正则块为准 - 注意：正则 location 中的
index仅在该正则匹配成功且请求 URI 以/结尾时触发；否则不参与索引查找
常见误用与规避建议
容易混淆的是把 index 当作“默认首页兜底逻辑”，但它实际只响应明确以 / 结尾的 URI。例如 /blog（无尾斜杠）不会触发任何 index 指令，哪怕你写了 index index.html。
- 需要统一处理无尾斜杠的“目录式访问”，应配合
rewrite或try_files，例如：try_files $uri $uri/ /index.html;—— 这样既检查文件，又检查目录（触发 index），最后 fallback - 避免在多个嵌套层级重复定义相同
index，除非语义不同（如静态资源用index.html，后端路由用index.php） - 调试时可用
error_log /var/log/nginx/debug.log debug;配合nginx -t和重载，观察 location 匹配过程
一个典型分层配置示例
以下配置清晰体现覆盖逻辑：
location / {
index index.html;
}
location /admin/ {
index admin.php;
}
location ~ \.php$ {
# 此处 index 不生效：正则 location 不处理目录索引，只处理 .php 文件请求
# 真正的 PHP 入口应由 fastcgi_pass + SCRIPT_FILENAME 控制
}→ 访问 / → 查找 index.html
→ 访问 /admin/ → 查找 admin.php
→ 访问 /admin（无斜杠）→ 不触发任何 index，可能 404
→ 访问 /admin/dashboard.php → 进入正则块，index 指令被忽略
