在本地开发WordPress主题或插件时，使用XAMPP搭建localhost环境是最常用的方案之一，整个过程不需要依赖远程服务器，所有操作都可以在本地完成，调试和修改都非常方便。
前期准备
首先需要下载两个核心文件，分别是XAMPP安装包和WordPress最新版压缩包。XAMPP要选择对应操作系统的版本，Windows用户选择Windows版即可，WordPress直接到官方站点下载zip格式的完整包。
安装XAMPP
运行XAMPP安装程序，按照提示完成安装，安装路径建议选择默认路径，避免后续出现权限问题。安装完成后启动XAMPP控制面板，点击Apache和MySQL对应的Start按钮，等待两个服务都显示绿色运行状态。
打开浏览器访问http://localhost，如果看到XAMPP的欢迎页面，说明环境已经正常运行。
准备WordPress文件
将下载好的WordPress压缩包解压，得到wordpress文件夹，把整个文件夹复制到XAMPP安装目录下的htdocs文件夹中。如果希望直接通过http://localhost访问，可以把wordpress文件夹里的所有文件直接放到htdocs根目录下，不需要保留外层文件夹。
创建WordPress数据库
WordPress运行需要独立的数据库存储内容，我们可以通过XAMPP自带的phpMyAdmin工具创建数据库。
打开浏览器访问http://localhost/phpmyadmin，进入phpMyAdmin管理页面，点击顶部导航栏的数据库选项，在新建数据库输入框中填写数据库名称，比如wordpress_local，排序规则选择utf8mb4_unicode_ci，点击创建按钮即可完成数据库创建。
这里不需要额外创建数据库用户，本地环境默认使用root用户，密码为空即可，后续配置WordPress时会用到这些信息。
配置并安装WordPress
打开浏览器访问http://localhost/wordpress（如果之前把文件放到了htdocs根目录，直接访问http://localhost），会进入WordPress安装向导页面。
首先选择语言，选择简体中文后点击继续，然后点击现在就开始进入数据库配置页面，按照以下信息填写：
- 数据库名：填写刚才创建的
wordpress_local - 用户名：填写
root - 密码：留空即可
- 数据库主机：默认填写
localhost - 表前缀：默认
wp_即可，也可以自定义避免冲突
填写完成后点击提交，如果提示数据库连接成功，就可以点击运行安装。
接下来填写站点基本信息：
- 站点标题：自定义本地测试站点的名称
- 用户名：设置WordPress后台登录用户名
- 密码：设置登录密码，建议记住该密码
- 电子邮件：填写自己的邮箱即可
- 搜索引擎可见性：本地测试建议勾选
建议搜索引擎不索引本站点
点击安装WordPress，等待安装完成，出现成功提示后就可以点击登录按钮，使用刚才设置的账号密码进入WordPress后台。
常见问题解决
页面显示404或无法访问
如果出现页面无法加载的情况，首先检查Apache服务是否正常运行，然后确认WordPress文件是否放到了正确的htdocs目录下。如果修改了Apache的端口号，访问时需要在localhost后加上对应端口，比如http://localhost:8080。
数据库连接错误
检查phpMyAdmin中数据库是否存在，用户名和密码是否填写正确，本地环境root用户默认无密码，不要填写错误密码。如果还是无法连接，可以打开wp-config.php文件检查数据库配置是否正确，该文件在WordPress根目录下，如果没有可以复制wp-config-sample.php重命名为wp-config.php后修改配置。
以下是wp-config.php中数据库配置部分的示例代码：
// ** 数据库设置 - 具体信息来自您正在使用的主机 ** // /** WordPress数据库的名称 */ define( 'DB_NAME', 'wordpress_local' ); /** 数据库用户名 */ define( 'DB_USER', 'root' ); /** 数据库密码 */ define( 'DB_PASSWORD', '' ); /** 数据库主机 */ define( 'DB_HOST', 'localhost' ); /** 创建数据表时默认的文字编码 */ define( 'DB_CHARSET', 'utf8mb4' ); /** 数据库整理类型。如不确定请勿更改 */ define( 'DB_COLLATE', 'utf8mb4_unicode_ci' );
伪静态规则不生效
WordPress的固定链接功能需要Apache开启mod_rewrite模块，打开XAMPP安装目录下的apacheconfhttpd.conf文件，找到#LoadModule rewrite_module modules/mod_rewrite.so这一行，去掉前面的#号，保存后重启Apache服务即可。
同时需要确认WordPress根目录下的.htaccess文件是否存在，如果不存在可以手动创建，内容如下：
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /wordpress/
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /wordpress/index.php [L]
</IfModule>
如果WordPress是放在htdocs根目录，把上面代码中的/wordpress/替换成/即可。
后续使用建议
本地部署完成后，你可以直接在htdocs/wordpress/wp-content/themes目录下开发主题，在wp-content/plugins目录下开发插件，修改后刷新页面就能看到效果，不需要每次都上传到远程服务器。如果需要迁移到线上服务器，只需要导出本地数据库，然后把整个WordPress文件夹上传到线上服务器，修改数据库配置即可完成迁移。
XAMPPWordPresslocalhostphpMyAdmin修改时间：2026-06-30 23:48:51