WordPress开发环境搭建:从零搭建WordPr

一、选对本地开发工具,省掉一半麻烦
对零基础用户来说,最省心的方案是集成环境。
推荐 XAMPP,它把 Apache(网页服务器)、MySQL(数据库)、PHP 和 phpMyAdmin 打包在一起,下载后直接启动就能用。
下载地址:https://www.apachefriends.org/zh_cn/index.html
注意:选择 PHP 版本 8.0 或 8.1 的 XAMPP,兼容最新的 WordPress。
安装时一路默认,但安装路径不要包含中文或空格,建议 C:\xampp。
安装完成后桌面上会出现 XAMPP Control Panel。
二、启动服务,创建数据库
- 打开 XAMPP Control Panel,点击 Apache 和 MySQL 后面的 Start 按钮。状态灯变成绿色表示启动成功。
- 打开浏览器,访问
http://localhost应该看到 XAMPP 欢迎页面。 - 点击面板上的 Admin 按钮(MySQL 那一行),进入 phpMyAdmin。
- 在 phpMyAdmin 中点击 新建,数据库名输入
wordpress_dev(字母小写),排序规则选utf8mb4_general_ci,点击 创建。
避坑:数据库名不要用大写或特殊字符,否则 WordPress 连接时会报错。
三、下载并配置 WordPress
- 访问 WordPress 中文官网 下载最新安装包。
- 将压缩包解压,把
wordpress文件夹整个复制到 XAMPP 的htdocs目录(默认是C:\xampp\htdocs)。 - 为了方便访问,可以把文件夹重命名为
mywp(不强制)。 - 现在用浏览器打开
http://localhost/mywp,会看到 WordPress 初始设置界面。 - 点击“开始”,填写数据库信息:
- 数据库名:wordpress_dev
- 用户名:root
- 密码:(留空)
- 数据库主机:localhost
- 表前缀:保持默认
wp_
- 点击“提交”,如果连接成功会提示“已准备好”。然后点击“运行安装程序”。
- 填写站点信息:站点标题自定,用户名
admin,密码用强密码,邮箱填自己的。建议勾选“限制搜索引擎索引”,开发环境不需要被收录。 - 点击“安装 WordPress”,完成后会自动登录后台。
四、常见错误与修复
404 页面打不开(伪静态问题)
如果修改固定链接后文章页面 404,需要在 Apache 中开启 mod_rewrite:
- 在 XAMPP 面板中点击 Apache 的 Config -> httpd.conf。
- 搜索
#LoadModule rewrite_module modules/mod_rewrite.so,去掉行首的#(即取消注释)。 - 搜索
,把下面的AllowOverride None改为AllowOverride All。 - 保存文件,重启 Apache 服务。
数据库连接错误
如果提示“建立数据库连接时出错”:
- 检查 MySQL 是否已启动(面板灯绿色)。
- 检查
wp-config.php中的数据库名、用户名、密码是否与 phpMyAdmin 中设置的一致。 - 如果本地有多个站点,确保表前缀不重复。
插件/主题安装提示需要 FTP
这是文件权限问题。
打开 C:\xampp\htdocs\mywp\wp-config.php,在最后一行 require_once 之前添加:
define('FS_METHOD', 'direct');然后保存,再安装插件就不需要 FTP 了。
五、验证你的开发环境是否正常
- 前台访问:打开
http://localhost/mywp应该看到默认主题的站点。 - 后台登录:访问
http://localhost/mywp/wp-admin,用设置的账号密码登录。 - 测试功能:新建一篇带图和代码块的测试文章,确认编辑器、媒体库、更新按钮都能正常使用。
- 数据库连接:在 phpMyAdmin 中查看
wordpress_dev数据库,应该已经自动生成了wp_posts等表。
至此,你的本地 WordPress 开发环境搭建完成。
后续可以用它测试主题开发、插件调试或学习 WordPress 二次开发。
遇到问题时建议先在日志窗口(XAMPP 面板的 Logs 按钮)查看错误信息,多数问题都能根据日志快速定位。