apache虚拟主机配置不一定必须启用vhost_alias模块；xampp默认已加载该模块，但手动配置块、确保httpd-vhosts.conf被主配置包含、设置正确的servername与documentroot、并验证语法和hosts解析才是关键。
Apache虚拟主机配置必须启用 vhost_alias 模块吗？
不需要。XAMPP 默认已加载 mod_vhost_alias，但二级域名本地测试根本用不到它——你真正需要的是手动配置 <virtualhost></virtualhost> 块，并确保 httpd-vhosts.conf 被主配置包含。
常见错误是只改了 hosts 文件却没启用虚拟主机配置，结果所有请求都落到默认站点（htdocs）上。
- 检查
XAMPP\apache\conf\httpd.conf中这行是否取消注释：Include conf/extra/httpd-vhosts.conf - 确认
httpd-vhosts.conf里每个<virtualhost></virtualhost>都有明确的ServerName和DocumentRoot - 重启 Apache 后用
httpd -t（在 XAMPP 控制面板里点“Shell”进入命令行执行）验证语法，避免配置错误导致服务起不来
Windows hosts 文件怎么写二级域名条目？
必须写成 127.0.0.1，不能用 ::1（IPv6 地址），否则 Chrome/Firefox 可能因 IPv6 优先策略跳过解析，表现为“无法访问此网站”或直接 fallback 到 DNS 查询。
每行一个映射，不支持通配符，二级域名要逐个列：
127.0.0.1 blog.local 127.0.0.1 api.dev 127.0.0.1 admin.test
注意：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 域名后不要加斜杠或端口，如
blog.local/或blog.local:8080是无效的 - 修改后无需重启系统，但浏览器缓存可能干扰，建议用
ping blog.local确认解析生效，再清空浏览器 DNS 缓存（chrome://net-internals/#dns） - 某些安全软件会劫持 hosts，若 ping 通但浏览器打不开，先临时禁用防护软件测试
DocumentRoot 路径写相对路径会失败
Apache 要求 DocumentRoot 必须是绝对路径，比如 C:/xampp/htdocs/blog。写成 htdocs/blog 或 ../htdocs/blog 会导致 403 Forbidden（权限拒绝）或直接 404。
更隐蔽的问题是路径中的反斜杠 \：Windows 下虽然能识别，但 Apache 内部处理时容易出错，统一用正斜杠 / 更稳妥。
- 推荐写法：
DocumentRoot "C:/xampp/htdocs/api"（双引号包裹，含正斜杠） - 对应
<directory></directory>块里必须有Require all granted（XAMPP 5.6+ 默认用新权限语法，旧版用Allow from all） - 如果目录含中文或空格，确保 Apache 服务以当前用户权限运行（XAMPP 控制面板里勾选“Svc”会以系统服务启动，可能无权读取用户目录）
为什么访问二级域名总跳转到 XAMPP 默认页？
最常被忽略的是 ServerName 和 ServerAlias 拼写与 hosts 条目不完全一致，包括大小写、多余空格、尾随点（blog.local.）——Apache 匹配是严格字符串比对。
另一个关键点：Apache 默认虚拟主机会吃掉所有未匹配的请求。如果你把自定义 <virtualhost></virtualhost> 放在 httpd-vhosts.conf 末尾，而前面有个泛匹配的 <virtualhost></virtualhost>（比如 XAMPP 自带的示例），那你的配置永远不生效。
- 把你的站点配置放在
httpd-vhosts.conf最顶部，或删掉文件开头的示例块 - 用
httpd -S查看当前生效的虚拟主机列表，输出里应明确列出你的ServerName - 如果仍不行，在
<virtualhost></virtualhost>块里加一行ErrorLog "logs/blog_error.log"，然后访问触发错误，去日志里看实际匹配的是哪个 vhost
多站点本质是请求 Host 头和配置的 ServerName 对齐，中间任何一环断开——hosts 解析、DNS 缓存、Apache 配置顺序、权限指令、路径拼写——都会让二级域名“看起来没反应”。调试时按这个链条逐段验证，比反复重装 XAMPP 有效得多。
