需修改httpd.conf中DocumentRoot及对应Directory路径为新位置(如D:/myweb),用正斜杠、确保文件夹存在且含首页、权限正确、无中文空格、非同步盘,改后重启Apache并验证。
修改
中的
和
路径
XAMPP 默认把 Web 根目录设在
,想换到 D 盘或 E 盘,核心就是改 Apache 的主配置文件。直接打开
,用文本编辑器(如 VS Code 或记事本)搜索
,你会看到类似这一行:
把它改成你想要的路径,比如
;紧接着找下面紧邻的
块,把引号里的路径也同步改成
。注意:路径分隔符用正斜杠
,Windows 下反斜杠
会导致 Apache 启动失败。
常见错误现象:
,控制台报错
或直接静默退出——大概率是路径写错、引号没闭合,或用了反斜杠。
确保目标文件夹有读取权限且存在
或
Apache 不会自动创建新根目录,你得手动建好文件夹(如
),并至少放一个测试文件。否则访问
会返回
——不是权限问题,而是 Apache 默认禁止列出目录内容,且找不到默认首页。
还要检查 Windows 文件权限:右键目标文件夹 →「属性」→「安全」→ 确保
或
有「读取和执行」权限。XAMPP 以普通用户身份运行,没有管理员权限时,若文件夹在受保护路径(如
)下,也会触发 403。
路径不能含中文或空格(如
或
),容易引发解析异常
避免使用 OneDrive、iCloud 等同步文件夹作为根目录,文件锁或延迟同步会导致 PHP 脚本加载失败
重启 Apache 并验证配置是否生效
改完配置后,必须重启 Apache 才能生效。通过 XAMPP Control Panel 点击
再
;如果提示「Apache shutdown unexpectedly」,说明配置出错,立刻打开
查最后一行错误信息,通常会明确指出哪一行、哪个路径有问题。
验证方式很简单:在新目录下放一个
,内容为
,然后浏览器访问
。如果输出
,说明成功;如果仍是旧页面,大概率是没重启服务,或者浏览器缓存了重定向(可尝试
强刷,或访问
显式指定)。
如果用了虚拟主机(
),别漏掉
里的路径
如果你额外配置了虚拟主机(比如设了
指向某个项目),那还得检查
。里面每个
块都有自己的
和
,这些路径不会随主配置自动更新,必须手动同步修改。
容易被忽略的一点:多个
指向不同盘符时,Apache 本身不排斥,但 Windows 下跨盘符的符号链接(symlink)默认不可用(除非启用开发者模式并管理员权限创建),所以别试图用软链绕过路径修改——直接改配置最稳。
httpd.confDocumentRootC:\xampp\htdocsC:\xampp\apache\conf\httpd.confDocumentRootDocumentRoot "C:/xampp/htdocs"D:/myweb"D:/myweb"/\Apache 无法启动Invalid directory pathindex.htmlindex.phpD:/mywebhttp://localhost403 ForbiddenUsersEveryoneC:\Program FilesD:/我的网站D:/my webStopStartC:\xampp\apache\logs\error.logindex.phphttp://localhostOKCtrl+F5http://localhost/index.phpvhostshttpd-vhosts.conflocal.devC:\xampp\apache\conf\extra\httpd-vhosts.confDocumentRootDocumentRoot