XAMPP中多个域名指向同一目录不能用多个同端口VirtualHost块，否则仅首个生效；正确做法是单个VirtualHost块内用ServerName加多个ServerAlias，并在hosts文件中逐条映射各域名至127.0.0.1。
直接说结论：XAMPP 中让多个域名指向同一目录，**不能靠多个 <VirtualHost> 块分别写相同 DocumentRoot**——那样会导致 Apache 仅匹配第一个，其余域名全部 fallback 到它，看似“生效”，实则不可控、易冲突。正确做法是用 ServerAlias 或复用单个 <VirtualHost> 块。
为什么多个 <VirtualHost *:80> 指向同一目录会失效
Apache 的虚拟主机匹配逻辑是：请求进来后，先比对 ServerName 和 ServerAlias；若都不匹配，就落到**第一个定义的 <VirtualHost> 块**（即“默认虚拟主机”）。即使你写了两个块，路径一样、端口一样、ServerName 不同，只要请求没精确命中第二个块的 ServerName，它就永远进不了第二个块——根本不会“并行生效”。
常见错误现象：
- 访问
site1.local正常，但site2.local也显示site1.local的内容 - 改了第二个块的
DocumentRoot，结果两个域名都变了——说明实际只在用第一个块 - 加了第三个体块，重启后 Apache 启动失败，报错
Syntax error on line X of httpd-vhosts.conf: DocumentRoot must be a directory（路径不存在或权限不对）
ServerAlias 是最简方案：一个块撑起所有别名
把所有想共用同一目录的域名，全塞进同一个 <VirtualHost> 块里，用 ServerAlias 补充。Apache 会把它们当“同一体”的不同入口处理，完全共享 DocumentRoot 和 <Directory> 权限配置。
实操要点：
-
ServerName写主域名（如dev.local），必须和hosts文件中的一致 -
ServerAlias每行一个，支持通配符（如*.dev.local），但注意 Windows hosts 不支持通配符映射，得手动列全 -
DocumentRoot只需写一次，路径必须存在、有读取权限、结尾不带斜杠 - 务必配好
<Directory>块，否则 403 Forbidden
示例：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<VirtualHost *:80>
DocumentRoot "C:/xampp/htdocs/myproject"
ServerName dev.local
ServerAlias test.local staging.local local.dev
<Directory "C:/xampp/htdocs/myproject">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
hosts 文件必须逐条映射，不能偷懒
浏览器根本不认识 ServerAlias，它只认 DNS 或 hosts 解析结果。哪怕你在 httpd-vhosts.conf 里写了 ServerAlias *.dev.local，Windows 的 hosts 文件也**不支持通配符语法**。
所以必须手动添加每一行：
- 用管理员权限打开
C:\Windows\System32\drivers\etc\hosts - 追加（不能有空格、不能用 tab、IP 必须是
127.0.0.1）：
127.0.0.1 dev.local 127.0.0.1 test.local 127.0.0.1 staging.local 127.0.0.1 local.dev
改完保存，无需重启系统，但浏览器可能缓存 DNS，建议用无痕窗口测试，或执行 ipconfig /flushdns。
验证顺序比重启更重要
很多人改完就猛点 XAMPP 控制面板里的 Start，结果 Apache 启动失败或静默挂掉——因为配置语法错了，但面板不报具体原因。
必须在重启前执行验证：
- 打开命令行（管理员权限），cd 到
XAMPP\apache\bin\ - 运行：
httpd -t - 输出
Syntax OK才算过关；否则会提示哪一行出错（比如引号没闭合、路径含中文、<Directory>缺少</Directory>） - 验证通过后再重启 Apache
最容易被忽略的是：改了 httpd-vhosts.conf 后，忘了确认 httpd.conf 里 #Include conf/extra/httpd-vhosts.conf 这行已取消注释——漏这一步，整个 vhosts 配置等于没写。
