本文详解 xampp 环境下 wordpress 本地部署失败的常见原因（尤其是未解压安装包导致的 404 错误），提供从解压、目录放置、权限验证到基础访问的完整实操指南。
本文详解 xampp 环境下 wordpress 本地部署失败的常见原因（尤其是未解压安装包导致的 404 错误），提供从解压、目录放置、权限验证到基础访问的完整实操指南。
当你在浏览器中输入 http://localhost/wordpress 或 http://localhost:80/wordpress 却看到如下错误页面：
Not Found The requested URL was not found on this server. Apache/2.4.52 (Win64) OpenSSL/1.1.1m PHP/8.1.4 Server at localhost Port 80
这并非 Apache、PHP 或端口配置故障，而极大概率是 WordPress 文件未被正确部署到 Web 根目录——这是初学者最常踩的“隐形坑”。
✅ 正确部署步骤（以 Windows + XAMPP 为例）
-
下载并解压 WordPress 安装包
- 前往 wordpress.org/download 下载最新 .zip 文件（如 latest-zh_CN.zip）；
- 关键动作：必须解压缩！ 右键 ZIP 文件 → 选择「全部解压缩…」→ 指定目标文件夹（例如 D:\xampp\htdocs\wordpress）；
- ❌ 错误做法：直接将 wordpress-6.x.x-zh_CN.zip 文件拖入 htdocs 目录——Apache 无法执行 ZIP 文件，自然返回 404。
-
确认目录结构合规
解压后，确保 D:\xampp\htdocs\wordpress\ 下存在以下核心文件与目录（部分列出）：D:\xampp\htdocs\wordpress\ ├── index.php ├── wp-admin/ ├── wp-content/ ├── wp-includes/ ├── wp-config-sample.php └── ...
? 提示：若你看到的是 wordpress\wordpress\（即解压后多了一层嵌套文件夹），请剪切内部所有内容，粘贴到 htdocs\wordpress\ 根下，避免路径冗余。
-
启动服务并验证基础环境
- 打开 XAMPP Control Panel → 启动 Apache（无需启动 Tomcat，WordPress 是 PHP 应用，与 Java/Tomcat 无关）；
- 访问 http://localhost/ 确认 XAMPP 首页正常；
- 再访问 http://localhost/wordpress/ —— 此时应看到 WordPress 安装向导（语言选择页），而非 404。
⚠️ 常见误区与澄清
Tomcat 报错（"Tomcat Not Found!"）可完全忽略
WordPress 不依赖 Java 或 Tomcat。XAMPP 中 Tomcat 是可选组件，未安装或未配置不影响 PHP 网站运行。无需安装 JDK/JRE——它们对 WordPress 部署毫无作用。端口号非必需显式标注
http://localhost/wordpress 与 http://localhost:80/wordpress 等价（HTTP 默认端口为 80）。若修改过 Apache 端口（如改为 8080），才需写成 localhost:8080/wordpress。权限与路径大小写无关（Windows）
Windows 文件系统不区分大小写，但请确保目录名拼写一致（如 wordpress 而非 WordPress 或 WP），避免人为混淆。
✅ 进阶建议：快速启动安装
首次访问 http://localhost/wordpress/ 后，按向导完成数据库配置即可：
- 数据库名：wordpress（需提前在 http://localhost/phpmyadmin/ 中创建）
- 用户名：root
- 密码：留空（XAMPP 默认 root 无密码）
- 数据库主机：localhost
完成后，WordPress 将自动生成 wp-config.php，你便可登录后台 http://localhost/wordpress/wp-admin/ 开始开发实践。
? 总结：404 的根源几乎总是“文件未解压”或“目录未正确展开”。与其反复重装 XAMPP 或安装无关组件（JDK/Tomcat），不如花 2 分钟检查 htdocs\wordpress\index.php 是否真实存在——这是诊断的第一步，也是最关键的一步。
