Apache的DirectoryIndex指令决定目录首页文件的查找顺序，需在配置文件中修改并重启服务；常见问题包括被VirtualHost或.htaccess覆盖、大小写敏感、模块未启用及语法错误。

Apache 的 DirectoryIndex 控制目录首页优先级

访问 http://localhost/ 时显示空白页或 404，不是路径错了，而是 Apache 默认只找特定文件名当“首页”——它按 DirectoryIndex 指令中列出的顺序依次查找。默认值通常是 index.html index.php，如果目录下只有 home.php 或 default.htm，就不会自动加载。

修改这个顺序，本质是改 DirectoryIndex 指令本身，不是改文件名或权限。

• 打开 C:/xampp/apache/conf/httpd.conf（Windows）或对应路径的配置文件
• 搜索 DirectoryIndex，找到类似这一行：

  DirectoryIndex index.html index.php

• 把它改成你想要的优先级，比如先找 home.php，再找 index.php，最后 fallback 到 index.html：

  DirectoryIndex home.php index.php index.html

• 保存后，必须重启 Apache（用 XAMPP Control Panel 点 Stop 再 Start，别点 Restart，它有时不重载该指令）

为什么改了还是不生效？检查这三处覆盖点

DirectoryIndex 很容易被其他配置覆盖，尤其在你启用了虚拟主机、.htaccess 或额外模块时。

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

• 检查 C:/xampp/apache/conf/extra/httpd-vhosts.conf：如果定义了 <virtualhost></virtualhost>，里面可能有独立的 DirectoryIndex 行，它会覆盖主配置
• 检查项目根目录下是否有 .htaccess 文件：它也能写 DirectoryIndex xxx.php，且优先级高于主配置
• 确认没启用 mod_dir 模块被禁用（极少见）：运行 C:\xampp\apache\bin\httpd.exe -M | findstr dir，应看到 dir_module (shared)；若没有，说明模块未加载，DirectoryIndex 不起作用

想让目录直接列文件（不找任何首页）？关掉 DirectoryIndex 就行

这不是“排序问题”，而是彻底跳过首页匹配逻辑，强制触发 Apache 的目录索引（前提是已开启 Options Indexes）。

• 把 DirectoryIndex 改成空值：

  DirectoryIndex

  （后面不跟任何文件名）
• 确保对应目录块启用了 Indexes：

  <Directory "C:/xampp/htdocs/myproject"> Options Indexes FollowSymLinks </Directory>

• 注意：如果同时存在 index.php 和空 DirectoryIndex，Apache 仍会显示该文件——因为 Indexes 只在找不到任何匹配首页时才激活

Windows 路径大小写和空格容易引发静默失败

Apache 在 Windows 上对路径大小写不敏感，但 DirectoryIndex 中的文件名是严格区分大小写的——Index.php ≠ index.php。

• 文件系统里实际是 INDEX.HTML，但配置写成 index.html，Apache 就找不到（尤其在 NTFS 启用大小写敏感时）
• 路径含空格（如 C:/My Project/site）必须用双引号包裹整个路径，但 DirectoryIndex 后面的文件名列表不能加引号，否则解析失败
• 验证语法是否正确：命令行运行 C:\xampp\apache\bin\httpd.exe -t，返回 Syntax OK 才可信

改 DirectoryIndex 看似简单，真正卡住人的往往是虚拟主机配置或 .htaccess 的隐式覆盖——先查这两处，比反复改主配置更省时间。