Git与XAMPP无直接集成关系,需将Git仓库置于XAMPP的htdocs目录内(如C:\xampp\htdocs\my-project),确保Apache能通过HTTP访问;每次Git更新后须手动刷新浏览器并验证路径、权限、PHP解析及Apache配置是否正确。

Git 和 XAMPP 本身没有集成关系,强行“集成”反而容易破坏开发流程的清晰性。 XAMPP 是本地 Web 服务运行环境(Apache + MySQL + PHP),Git 是代码版本控制工具,二者职责完全不同。你真正需要的,是让 Git 管理你的 PHP/HTML 项目文件,并确保这些文件能被 XAMPP 正确提供服务——这不是“集成”,而是路径对齐与工作流协调。
Git 仓库该放在 XAMPP 的哪个目录下?
必须把 git init 初始化的仓库放在 htdocs 目录内(如 C:\xampp\htdocs\my-project),或其子目录中。XAMPP 默认只从 htdocs 提供 HTTP 访问,Git 仓库放错位置会导致:浏览器打不开页面、403 Forbidden、或 Apache 日志报 File does not exist。
不建议把整个 htdocs 当作一个 Git 仓库——它可能混有多个项目、测试文件或临时脚本,权限和提交历史会混乱。更合理的做法是:
- 每个项目单独建仓,例如
C:\xampp\htdocs\blog、C:\xampp\htdocs\api - 在项目根目录执行
git init,而非在htdocs根目录 - 用
.gitignore排除vendor/(Composer)、node_modules/、.env.local等非源码文件
为什么在 htdocs 里执行 git clone 后网页打不开?
常见原因不是 Git 问题,而是路径或权限错位。典型现象包括:404 Not Found(URL 路径没对上)、500 Internal Server Error(PHP 报错但未显示)、或直接下载 PHP 文件(Apache 未解析 PHP)。
请按顺序检查:
- 确认 Apache 已启动,且
httpd.conf中LoadModule php_module和AddHandler application/x-httpd-php .php未被注释 - 确认克隆后的项目路径可被浏览器访问,例如
http://localhost/my-project/index.php—— 注意 URL 路径必须与htdocs下的目录名严格一致 - 如果项目含重写规则(如 Laravel 的
.htaccess),需开启 Apache 的mod_rewrite并设置AllowOverride All在对应目录配置中 - Windows 下注意大小写:Git 仓库名是
MyProject,但 URL 写成/myproject/可能 404(取决于 Apache 配置,但默认区分)
Git 提交后如何快速验证 XAMPP 服务是否生效?
不要依赖“刷新浏览器”来判断代码是否更新——Git 提交不等于文件自动部署,尤其当你修改的是 PHP 逻辑、数据库迁移或配置项时,需明确触发点。
关键动作清单:
- 每次
git pull或git checkout后,手动刷新浏览器并观察响应内容,而非仅看状态码 - PHP 修改后若无反应,检查浏览器是否缓存了旧响应(尝试
Ctrl+F5或禁用缓存调试) - 涉及数据库变更时,Git 不会自动执行
ALTER TABLE,你得手动运行 SQL 或迁移脚本 - 修改
php.ini或httpd.conf后,必须重启 Apache 才生效,XAMPP 控制面板点Stop再Start,不能只刷新页面
最容易被忽略的一点:Git 跟踪的是文件内容,不是服务器状态。你提交了一个修复 Bug 的 PHP 补丁,不代表 Apache 就立刻加载了新代码——它只在下次请求时读取磁盘文件。所以“Git + XAMPP”真正的衔接点,永远是那个具体的文件路径,以及你有没有真的把要运行的代码放到了 htdocs 下正确的位置。










