index指令不控制autoindex开关，仅决定是否跳过目录列表：当指定的默认文件存在且可读时直接返回，否则在autoindex on时才显示目录列表。
在 Nginx 中，index 指令本身**不控制是否开启自动目录列表（autoindex）**，但它会显著影响用户能否“到达”需要触发 autoindex 的场景。换句话说：如果 index 指令匹配到一个存在的文件，Nginx 就直接返回该文件，根本不会走到 autoindex 这一步；只有当所有 index 指定的文件都不存在时，Nginx 才可能考虑展示目录列表——但前提是 autoindex on 已显式启用。
index 指令的作用是“尝试返回默认文件”，不是“决定是否列目录”
index 是一个按顺序匹配的指令，例如：
index index.html index.php;
当用户请求 / 或 /static/ 这类以 / 结尾的 URI 时，Nginx 会依次检查根目录（或 location 对应的 root/alias 路径）下是否存在 index.html、index.php。只要任一文件存在且可读，Nginx 就直接返回它，并终止后续处理流程。
此时即使你配置了 autoindex on，也不会生效——因为请求早已被 index 截获并响应。
autoindex 只在“无默认文件可返回”时才有机会触发
要让目录列表真正显示出来，必须同时满足两个条件：
-
autoindex on;已在对应location块中启用 -
index列出的所有文件在该目录下均不存在（或不可读）
例如，某 location 配置如下：
location /files/ {
alias /data/uploads/;
index index.htm;
autoindex on;
}
当用户访问 /files/ 时：
→ 若 /data/uploads/index.htm 存在 → 返回该文件，不显示列表
→ 若该文件不存在 → Nginx 启动 autoindex，列出 /data/uploads/ 下所有可见文件
常见误解与调试建议
-
别以为开了 autoindex 就能看见列表：先检查
index文件是否存在，用ls -l /path/to/dir确认 - index 文件权限也很关键：即使文件存在，若 Nginx 工作进程（如 www-data）无读取权限，也会跳过它，转而尝试 autoindex
- 注意 root 和 alias 的路径拼接逻辑：错误的路径设置可能导致 index 文件实际位置与预期不符，看似“不存在”
-
临时验证 autoindex 是否生效：可临时注释或清空
index行（如index "";），再测试请求
小结：两者职责分明，协同工作
index 负责“友好落地”，把用户导向默认页面；autoindex 负责“兜底展示”，在没有默认页时提供目录视图。它们不是互斥功能，而是请求处理链上的前后环节。理解这个先后关系，就能准确预判用户看到的是页面、404，还是目录列表。
