XAMPP搭建WordPress详细步骤教程

本文深入剖析了在XAMPP本地环境中搭建WordPress时最常见、最易被忽视的五大故障根源：Apache/MySQL看似运行实则未就绪、端口冲突与服务监听异常、WordPress文件目录结构错误（尤其是解压嵌套和中文/空格命名）、数据库配置关键陷阱（特别是DB_HOST必须填localhost而非127.0.0.1、utf8mb4字符集强制要求及wp-config.php的手动正确编辑），以及浏览器缓存和PHP扩展未启用等隐性干扰；全文以实战排错逻辑为主线，提供精准命令行检测、日志定位、配置校验和避坑清单，直击90%用户“装不上”的核心痛点，助你快速绕过弯路，真正实现开箱即用的本地WordPress开发环境。

WordPress 在 XAMPP 上跑不起来，大概率不是 WordPress 的问题，而是 Apache 或 MySQL 没真启动、端口被占、htdocs 目录结构错、数据库没建对，或者 wp-config.php 里填了 127.0.0.1 而不是 localhost。

Apache 和 MySQL 显示 Running 但实际没干活

XAMPP 控制面板上绿色“Running”只是进程起来了，不代表服务就绪。Apache 可能监听了错误端口，MySQL 可能因 root 密码变更或端口冲突而静默失败。

• 在命令行运行 netstat -ano | findstr :80（Windows）或 lsof -i :80（macOS/Linux），确认 httpd.exe 或 apache2 真正在用 80 端口；若被 Skype、IIS、Zoom 或其他程序占用，得先关掉它们
• 点 XAMPP 控制面板的 Shell 按钮，输入 mysql -u root -p，直接回车（默认空密码）；如果报 Access denied for user 'root'@'localhost'，说明密码被改过，要么重置，要么在 wp-config.php 里填对新密码
• 检查 Apache 错误日志：C:\xampp\apache\logs\error.log，常见提示如 AH00072: make_sock: could not bind to address [::]:80 就是端口冲突

WordPress 文件放错位置或解压嵌套了

访问 http://localhost/wordpress 出现 403、404 或空白页，八成是文件没放对——不是路径名错了，就是目录结构多了一层。

• 用 7-Zip 或 WinRAR 右键解压，选“解压到当前文件夹”，确保 wp-admin、wp-includes、wp-config.php 这些文件直接出现在 C:\xampp\htdocs\wordpress\ 下，而不是 C:\xampp\htdocs\wordpress\wordpress-6.5.3-zh_CN\
• 别把 wordpress-6.5.3-zh_CN.zip 整个丢进 htdocs，也别保留 .zip 后缀
• 文件夹名必须是纯英文、无空格、无中文，比如 myblog 可以，我的博客 或 wordpress test 不行
• 如果想用 http://localhost 直接访问，就把 WordPress 所有文件解压后复制进 C:\xampp\htdocs\ 根目录（覆盖前建议先重命名原 index.php 备份）

数据库创建和 wp-config.php 配置最容易踩的坑

安装页面卡在“连接数据库”、提示 Sorry, I can’t write the wp-config.php file.，基本是权限、路径或配置项写错了。

• 进 http://localhost/phpmyadmin，左侧点“数据库”，输库名（如 wp_local），字符集选 utf8mb4，排序规则选 utf8mb4_unicode_ci ——别用 utf8，WordPress 6.0+ 强依赖 utf8mb4
• wp-config.php 必须手动创建：复制 wp-config-sample.php → 重命名为 wp-config.php → 用 VS Code 或 Notepad++ 编辑（别用系统记事本，容易编码出错）
• 关键四行必须对：

  define('DB_NAME', 'wp_local');
  define('DB_USER', 'root');
  define('DB_PASSWORD', '');
  define('DB_HOST', 'localhost');

  注意：DB_HOST 必须是 localhost，不是 127.0.0.1 ——XAMPP 的 MySQL 默认只认 localhost，填错就连接不上

• 如果改过 root 密码，DB_PASSWORD 就不能留空；如果新建了专用用户（如 wp_user），就得同步改 DB_USER 和 DB_PASSWORD

浏览器缓存和 php.ini 设置干扰安装流程

明明配置都对了，但页面还是跳回安装向导、或提交后空白，很可能是缓存或 PHP 扩展没开。

• 清空浏览器缓存，或直接用无痕窗口访问 http://localhost/wordpress
• 检查 C:\xampp\php\php.ini，确认以下扩展已启用（去掉前面的分号）：

  ;extension=mysqli
  ;extension=mbstring
  ;extension=openssl

  改完重启 Apache

• PHP 版本兼容性：XAMPP 8.2+ 自带 PHP 8.2，WordPress 官方支持 PHP 8.0–8.3，但部分老插件可能在 PHP 8.2 下报 Deprecated 警告，不影响安装，但上线前得测试

最常被忽略的是 DB_HOST 填成 127.0.0.1、解压多套一层目录、以及用记事本编辑 wp-config.php 导致 BOM 头乱码——这三个点只要扫一遍，90% 的“装不上”问题当场解决。

今天关于《XAMPP搭建WordPress详细步骤教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于XAMPP的内容请关注golang学习网公众号！