XAMPP虚拟主机配置教程 多域名本地访问指南

本文直击XAMPP虚拟主机配置失败的核心痛点——90%的问题并非配置写错，而是httpd-vhosts.conf未被Apache加载或hosts文件映射失效；手把手教你三步排障：取消httpd.conf中Include注释并用httpd -t验证语法、在hosts中精准添加127.0.0.1域名映射（推荐.test/.localhost后缀避开浏览器强制HTTPS）、为每个站点独立配置VirtualHost并务必设置兜底localhost和Require all granted权限，再配合error.log日志与Network面板快速定位真实症结，让多域名本地开发真正开箱即用。

XAMPP 虚拟主机配置失败，90% 是因为 httpd-vhosts.conf 没被 Apache 加载，或者 hosts 文件映射没生效——不是配置写得不对，是根本没走到那一步。

确认 Apache 是否加载了虚拟主机配置

Apache 默认不读 httpd-vhosts.conf，必须手动启用。很多人改完配置重启 Apache 却仍访问 localhost，问题就出在这。

• 用管理员权限打开 XAMPP\apache\conf\httpd.conf
• 搜索 Include conf/extra/httpd-vhosts.conf
• 确保该行前面没有 #；如果有，删掉它
• 保存后，在终端运行 httpd -t 验证语法（返回 Syntax OK 才算通过）

Windows hosts 文件必须匹配 ServerName

浏览器输 myapp.local 却跳转到 XAMPP 默认页？说明 DNS 解析没走本地，而是被系统或路由器拦截了。

• 以管理员身份打开 C:\Windows\System32\drivers\etc\hosts
• 末尾新增一行：127.0.0.1 myapp.local（不能有空格、不能用 www. 前缀除非你也在 ServerName 里写了）
• 如果用的是 .dev 或 .app，注意 Chrome 83+ 强制 HTTPS 重定向，建议改用 .test 或 .localhost
• 改完 hosts 后，执行 ipconfig /flushdns 清除 DNS 缓存

httpd-vhosts.conf 中每个 必须完整且互斥

多个站点共存时，Apache 会按顺序匹配第一个 ServerName 成功的块。如果漏了默认站点，所有未匹配域名都会落到第一个定义的 VirtualHost 上。

• 删除 httpd-vhosts.conf 中所有带 ## 的示例注释块（它们不是注释，是非法语法）
• 为每个域名写一个独立的 块，DocumentRoot 必须是绝对路径，结尾不加斜杠
• 务必在最上面加一个“兜底”配置，处理 localhost 请求：
  

  
      DocumentRoot "D:/xampp/htdocs"
      ServerName localhost
  

• 块里必须包含 Require all granted（Apache 2.4+），旧版的 Allow from all 会直接 403

常见错误现象与快速定位方式

配置看似都对，但就是打不开页面？别猜，用三步验证法：

• 访问 http://127.0.0.1:80 —— 看是否显示 XAMPP 默认页（确认 Apache 正常运行）
• 访问 http://myapp.local 并打开浏览器开发者工具 → Network 标签 → 查看请求是否发到了 127.0.0.1（如果不是，说明 hosts 失效）
• 查看 XAMPP\apache\logs\error.log，搜索关键词 AH00558（配置加载警告）、AH00112（无效指令）、Permission denied（目录权限不足）
• 如果改了端口（比如 *:8080），记得在 httpd.conf 里同步修改 Listen 8080，否则 Apache 根本不监听那个端口

最容易被忽略的是：改了 httpd.conf 或 httpd-vhosts.conf 后没运行 httpd -t 就重启 Apache，结果服务根本没起来，而控制面板显示“Running”只是假象。

今天关于《XAMPP虚拟主机配置教程 多域名本地访问指南》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于XAMPP的内容请关注golang学习网公众号！