WordPress在XAMPP上跑不起来,八成是Apache或MySQL服务未真正就绪、wp-config.php配置错误(如DB_HOST填127.0.0.1而非localhost)、WordPress未正确解压至htdocs导致路径嵌套、php.ini缺失mysqli/mbstring扩展,或目录权限/中文路径引发解析失败。

WordPress 在 XAMPP 上跑不起来,八成不是 WordPress 本身的问题,而是 httpd.conf 或 php.ini 里几个关键配置没对上,或者 MySQL 服务根本没启动。
确认 Apache 和 MySQL 真正启动成功
控制面板显示 “Running” 不代表服务就绪——Apache 可能监听了错误端口,MySQL 可能因端口冲突或 root 密码不匹配而静默失败。
- 在命令行执行
netstat -ano | findstr :80,确认 80 端口是否被httpd.exe占用;若被 Skype、IIS 或其他程序占了,得先关掉它们 - 点 XAMPP 控制面板的
Shell按钮,输入mysql -u root -p,直接回车(默认空密码)。如果报错Access denied for user 'root'@'localhost',说明 root 密码被改过,需重置或改用新密码登录 - 访问
http://localhost能看到 XAMPP 欢迎页,才说明 Apache 真正跑起来了;访问http://localhost/phpmyadmin能打开界面,才说明 MySQL + phpMyAdmin 正常联动
WordPress 文件必须正确解压到 htdocs 目录下
很多人把整个 wordpress-6.5.3-zh_CN.zip 直接丢进 htdocs,或者解压后还留着 wordpress-6.5.3-zh_CN/ 这层目录,导致访问 http://localhost/wordpress 时 403 或 404。
- 用 7-Zip 或 WinRAR 右键 → “解压到当前文件夹”,确保
wp-admin、wp-includes、wp-config-sample.php等文件**直接出现在**htdocs/wordpress/下,而不是htdocs/wordpress/wordpress-6.5.3-zh_CN/ - 避免中文路径或空格:比如
htdocs/我的网站/或htdocs/wordpress test/,Apache 可能解析失败 - 想用根域名访问(即
http://localhost),就把 WordPress 文件直接放进htdocs/,覆盖原index.php(XAMPP 默认页可先重命名备份)
wp-config.php 的数据库参数必须严格匹配 XAMPP 默认行为
安装页面卡在“连接数据库”或提示 Sorry, I can’t write the wp-config.php file.,基本是因为目录不可写,或填错了 MySQL 主机名。
- 复制
wp-config-sample.php,重命名为wp-config.php,用 VS Code 或 Notepad++ 编辑(别用记事本,编码易出错) -
DB_NAME填你在 phpMyAdmin 里建好的库名(如wordpress_local);DB_USER是root;DB_PASSWORD默认留空;DB_HOST必须是localhost,不能填127.0.0.1(XAMPP 的 MySQL 默认只认localhost) - 字符集推荐选
utf8mb4_unicode_ci(比旧版utf8_general_ci更安全,支持 emoji)
php 扩展和权限问题最容易被忽略
即使 Apache 和 MySQL 都绿了,WordPress 仍可能白屏或报错,常见于 PHP 模块未启用或目录权限异常。
- 打开
C:\xampp\php\php.ini,确认以下扩展已取消注释:extension=mysqli、extension=mbstring、extension=openssl(缺一不可) - 保存
php.ini后,必须重启 Apache 才生效 - 检查
htdocs/wordpress/目录权限:右键 → 属性 → 安全 → 确保Everyone或当前用户有“读取和执行”“列出文件夹内容”“读取”权限(写入权限非必需,但安装阶段建议临时开启) - 浏览器缓存有时会干扰安装流程,遇到奇怪跳转或空白页,可尝试
Ctrl+Shift+R强刷,或换无痕窗口重试
真正卡住的地方往往不在 WordPress 安装向导里,而在 DB_HOST 填成 127.0.0.1、php.ini 没重启、或解压路径多了一层嵌套——这些细节不报错,但直接让整个流程停在第一步。


















