跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

如何将 XAMPP 的 Web 根目录(htdocs)修改为非系统盘的其他文件夹

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

相关文章