XAMPP自定义域名配置教程

想让本地 XAMPP 项目通过自定义域名（如 myproject.test）顺利访问，却总卡在“改了 hosts 还打不开”？根本原因往往不是 Apache 没启动，而是 hosts 文件未真正生效——你可能没用管理员权限保存、忘了清 DNS 缓存（ipconfig /flushdns）、未重启 Apache，或误用了不规范的域名后缀（如 .com、.dev）。本文直击高频踩坑点：必须用 127.0.0.1（而非错误的 0.0.1）、严格采用 IETF 预留的 .test 后缀、确保 hosts 路径正确且格式零空格，并同步配置 Apache 虚拟主机与重启流程——一套操作下来，才能让域名精准指向你的本地项目，告别 404、连接拒绝和跳转默认页的困扰。

必须用管理员权限编辑，否则保存失败；hosts 文件改完不重启 Apache 或清 DNS 缓存，浏览器仍会走公网 DNS。

为什么改了 hosts 还打不开 myproject.test？

常见错误现象是输入域名后跳转到 404、连接被拒绝，或直接打开 XAMPP 默认页。这不是 Apache 没启动，而是系统根本没把域名解析到本地——因为 hosts 文件没生效。

• Windows 下必须以「管理员身份运行」记事本（或其他编辑器），否则保存时会被静默拦截
• 路径必须是 C:\Windows\System32\drivers\etc\hosts，不是桌面或文档里随便复制的同名文件
• 行末不能有多余空格或中文标点，格式严格为：127.0.0.1 myproject.test（注意用英文点号）
• 改完后执行 ipconfig /flushdns 清除本地 DNS 缓存，否则旧缓存可能持续数分钟

该用 127.0.0.1 还是 0.0.1？

Windows 和主流 Apache 都只认 127.0.0.1。虽然部分资料写 0.0.1，但那是过时写法或笔误，实际会导致解析失败。

• 127.0.0.1 是标准 IPv4 回环地址，兼容性最好
• 0.0.1 不是合法 IPv4 地址，现代 Windows 系统会忽略该行
• 如果项目需 HTTPS 或 HTTP/2 调试，后续可配合 localhost + 自签名证书，但 hosts 层仍用 127.0.0.1

能直接用 .com 或 .cn 后缀吗？

技术上可以，但强烈不建议。例如写 127.0.0.1 myapp.com，一旦你未来注册了真实 myapp.com，本地开发就会和线上冲突，浏览器可能加载混合内容或跳转失败。

• 推荐使用保留域名后缀：.test、.localhost、.invalid（IETF 标准预留）
• .dev 已被 Google 强制 HTTPS 重定向，Chrome 会自动跳 https://，本地无证书就报错
• 避免用 .local，它在 macOS 和部分 Linux 上被 mDNS 占用，可能导致解析异常

改完 hosts 后 Apache 还没响应？检查这三处

hosts 只管「域名→IP」，Apache 才管「IP+端口+Host 头→哪个项目」。缺一不可。

• 确认 httpd.conf 中 Include conf/extra/httpd-vhosts.conf 这行未被注释（前面没 #）
• 确认 httpd-vhosts.conf 里 ServerName 和 hosts 里写的域名**完全一致**（包括大小写、有无 www）
• 重启 Apache 必须点 XAMPP 控制面板的 Stop → Start，别只点 Restart，它有时跳过配置重载

真正容易被忽略的是：hosts 文件修改后，浏览器可能还在用旧缓存，且 Apache 的虚拟主机匹配依赖 Host 请求头，而这个头是否发送，受域名格式和浏览器策略影响。用 .test + 127.0.0.1 + 显式重启 Apache，是最稳的起点。

理论要掌握，实操不能落！以上关于《XAMPP自定义域名配置教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！