在XAMPP中绑定本地域名到指定项目目录，核心就是修改系统的hosts文件让域名指向127.0.0.1，再配置Apache的虚拟主机（vhost）功能，将请求转发到你的项目根目录。这两步缺一不可,下面拆解完整流程。
XAMPP绑定域名到项目目录前的准备工作
动手之前，先理清原理能帮你少走弯路，本地域名绑定不是XAMPP单方面的事，它涉及系统域名解析和Apache虚拟主机配置两个环节，系统负责把域名翻译成IP地址，Apache负责根据域名决定加载哪个目录的代码，两者对接成功,域名才能正常工作。
需要关闭可能占用80端口的程序，比如IIS、Skype或其它集成环境，端口冲突是新手最常见的坑，Apache服务根本无法启动，域名自然打不开，打开XAMPP控制面板，如果Apache状态显示红色叉号,多半就是端口问题。
检查XAMPP安装目录和项目路径
你要确定两个关键路径：XAMPP安装在哪，项目文件放在哪，多数用户的XAMPP装在C:xampp，项目目录可以是C:xampphtdocsmyproject，也可以是你自定义的任意位置，比如D:workmyproject，强烈建议先想清楚路径再动手,因为虚拟主机配置里写错路径是第二高发的问题。
路径中不要带中文和特殊字符，否则Apache解析时容易出现诡异错误，业内专家指出,使用纯英文路径能规避绝大多数因字符编码导致的加载失败问题。
XAMPP虚拟主机配置多个域名的完整步骤
现在进入正题，这里用我自己的实践流程带你走一遍，假设你要把myproject.test绑定到D:workmyproject目录。
第一步：修改hosts文件，让域名指向本机
hosts文件位置取决于操作系统：
- Windows系统：
C:WindowsSystem32driversetchosts - macOS / Linux系统：
/etc/hosts
用记事本或VS Code打开hosts文件（Windows需要管理员权限）,在文件末尾添加一行：
0.0.1 myproject.test保存关闭，这一步的含义是：当你访问myproject.test时，系统会将请求发送到本机，如果你用localhost访问一切正常,那这个步骤基本不会出问题。
常见疑问：hosts文件修改不生效怎么办？
多数情况下是缓存问题，打开命令提示符（CMD）,执行以下命令刷新DNS缓存：
ipconfig /flushdns如果还不行，检查hosts文件是否被杀毒软件拦截，或者文件编码不是UTF-8导致解析失败。
第二步：启用Apache的httpd-vhosts.conf配置文件
打开C:xamppapacheconfhttpd.conf文件,搜索以下内容：
# Virtual hosts
Include conf/extra/httpd-vhosts.conf把这一行前面的注释符号删掉，让Apache加载虚拟主机配置文件，这一步做漏了,后面所有虚拟主机配置都不会生效。
第三步：编辑httpd-vhosts.conf，声明域名和目录的绑定关系
打开C:xamppapacheconfextrahttpd-vhosts.conf，文件末尾默认有两个示例配置（example.com），不用管它们，直接往下添加你的配置：
<VirtualHost :80>
DocumentRoot "D:/work/myproject"
ServerName myproject.test
<Directory "D:/work/myproject">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>配置里DocumentRoot是项目目录，ServerName是你刚才在hosts里绑定的域名，<Directory>区块控制目录访问权限，注意路径里的斜杠要写正斜杠，Windows反斜杠会触发转义问题。
第四步：重启Apache验证绑定结果
在XAMPP控制面板中，点击Apache的Stop再点Start,或者用命令行工具执行：
C:xamppapachebinhttpd.exe -k restart重启完成后，浏览器输入http://myproject.test，如果能看到你的项目页面,说明绑定成功。
XAMPP本地环境绑定域名的进阶配置
一个站点搞定后，往往还想加更多项目，XAMPP支持在同一份配置里添加多个虚拟主机，规则很简单：每个域名对应一个<VirtualHost>块。
如何添加第二个域名到不同项目目录
继续在httpd-vhosts.conf里追加配置：
<VirtualHost :80>
DocumentRoot "D:/work/another-project"
ServerName another.test
<Directory "D:/work/another-project">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>别忘了回到hosts文件,再加一行：
0.0.1 another.test刷新DNS缓存，重启Apache，新域名就能用了，这里有个使用细节值得提醒：如果你只用虚拟主机配置，默认的http://localhost访问可能会失效，因为Apache会优先匹配第一个<VirtualHost>
块作为默认站点，如果你还需要localhost继续工作,把localhost显式配置为htdocs目录：
<VirtualHost :80>
DocumentRoot "C:/xampp/htdocs"
ServerName localhost
</VirtualHost>端口绑定：如何让域名走指定端口
默认80端口不够用或不方便时，可以让域名走8080或更多端口，这在测试带有固定回调地址的程序（如微信支付回调）时很常见。
首先在C:xamppapacheconfhttpd.conf中找到这行：
Listen 80在这一行下面添加你需要的监听端口：
Listen 8080然后在httpd-vhosts.conf中，把<VirtualHost :80>改成<VirtualHost :8080>,访问时带上端口号：
http://myproject.test:8080操作路径和目录绑定逻辑完全一样,只是入口端口变了。
XAMPP绑定域名不生效的常见原因排查
我还想聊聊故障排查，因为你也可能会踩这些坑，这部分的思路比具体步骤更重要，按顺序检查,轻松找到问题。
Apache启动失败，检查80端口占用
启动Apache报错时,先在命令行执行：
netstat -ano | findstr :80看输出结果，如果有PID占用，记住最后一列的数字，然后打开任务管理器，找到该PID对应的进程，通常是VMware、IIS或迅雷等软件抢占端口，修改这些软件的端口设置,或者给Apache换一个监听端口。
目录权限不足，提示403 Forbidden
出现403大概率是目录权限配置问题，检查<Directory>标签里的Require all granted是否遗漏，行业共识认为，忘记给新目录添加访问授权是Apache配置中最常见的权限错误，同时确认目录路径真实存在,没有拼写错误。
域名没有指向本机IP
hosts文件里的IP写成了:1格式（IPv6）或本地局域网IP，而Apache只监听了IPv4的80端口，也会导致连接失败，统一使用0.0.1解决，有些Windows版本会预置:1 localhost行,加载IPv6解析时反而绕过了IPv4映射。
配置语法错误，Apache拒绝加载
修改完配置后,可以打开命令行验证语法：
C:xamppapachebinhttpd.exe -t如果有语法错误，这个命令会直接输出错误行号和原因，比在浏览器里瞎试高效得多，这是我个人强烈建议每个开发者养成的习惯，线上环境出问题时,这条命令能救你一命。
本地域名绑定后的性能与维护建议
绑定完成后,还有几个使用建议让开发体验更顺滑。
定期备份hosts和vhosts配置，重装系统或更换电脑时，这两份文件是恢复环境的关键，hosts文件放一份备份到云盘,vhosts配置可以导出为独立配置文件。
使用通配符域名，减少hosts维护量，如果你的项目站点多,可在hosts里做泛解析：
0.0.1 .test配合Apache的ServerAlias，可以让a.test、b.test同时指向一个入口脚本，然后根据域名在代码里做路由分发,这个技巧在日常多项目并行开发时相当省时间。
改用自定义域名后缀。.test、.dev这类保留域名后缀，不容易和线上真实域名混淆，有些浏览器（如Chrome旧版）会强制将.dev域名跳转HTTPS，建议用.test后缀最保险，根据百度搜索流量统计，近年来“XAMPP本地域名配置”相关检索量持续攀升，多人协同或端口调试时，一套规范的本地域名方案能显著提升工作效率,避免因路径差异引发的联调问题。
对你的本地开发环境来说，域名绑定不是必需项，但确实是简化流程的好手段，写死IP和端口的日子过去后，你会发现代码里再也不需要满屏的localhost:8080了。
配置完成之后，日常开发和调试的效率提升是立竿见影的，如果你后续遇到ThinkPHP、WordPress这类自带伪静态规则的项目，还需要额外配置Apache的mod_rewrite模块，那就是另一个话题了，记住核心原则：hosts管域名去哪个IP，vhosts管IP加载哪个目录，清晰拆解,不再搞混。
Q&A：XAMPP绑定域名常见疑问解答
Q：XAMPP能不能直接绑定一个没有在hosts里写过的域名？
不能，Apache虚拟主机只负责接收请求，域名解析由hosts文件完成，不写hosts映射，域名会去公网DNS查询，找不到对应IP就返回无法访问，两步必须同时完成，这也是本地开发环境与线上服务器配置的最大区别：线上有DNS服务器帮忙解析,本地只能靠hosts文件硬映射。
Q：绑定多个域名时，为什么访问http://localhost打开的是第一个虚拟主机的页面？
Apache默认将配置文件中第一个<VirtualHost>块设为默认站点，当你访问一个映射到本机但没有明确配置的域名时，Apache会回落到第一个虚拟主机，如果想保留localhost页面,把localhost虚拟主机写在文件最前面即可。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/617245.html
