如何正确上传本地测试完成的WordPress自定义主题替换现有旧主题

前置必做准备（避免线上故障） #

• 提前对线上站点做全量备份，包含所有站点文件和数据库，部署出错时可直接回滚恢复
• 确认本地测试的WordPress版本和线上站点版本一致，避免出现版本不兼容导致的功能报错
• 将本地的主题文件夹打包为.zip格式，注意不要嵌套文件夹：压缩包打开后需直接展示style.css、functions.php等核心文件，不要外层额外套一层同名文件夹

方法1：后台直接上传（适用于主题压缩包小于2M、无服务器权限的场景） #

• 登录线上WordPress后台，进入外观 - 主题 - 添加新主题
• 点击页面顶部的上传主题按钮，选择本地打包好的主题zip包，点击现在安装
• 安装完成后先点击预览，确认主题在线上现有内容环境下的样式、功能全部正常，无错位、功能报错
• 确认无误后点击启用，即可完成旧主题的替换
• 部署完成后建议用无痕模式访问全站所有页面，确认前台所有功能、样式符合预期

方法2：FTP/SFTP上传（适用于大体积主题、后台上传有大小限制的场景） #

• 用FTP工具连接线上站点服务器，进入站点根目录下的wp-content/themes/文件夹
• 将本地解压后的主题文件夹（包含所有主题文件的完整目录）直接上传到该目录下，文件夹权限设置和目录内其他主题保持一致即可，通常为755权限
• 上传完成后登录WordPress后台，进入外观 - 主题即可看到上传完成的新主题
• 同样先点击预览确认所有功能正常，再点击启用
• 前台全量验证站点显示和功能状态即可

上线后必查项 #

• 检查自定义菜单、小工具、主题设置项是否和本地测试配置一致，部分主题配置不会随主题文件同步，需要手动调整
• 检查表单、搜索、评论等交互功能是否正常运行
• 检查图片、视频等媒体资源加载是否正常，若本地测试用了绝对路径的资源，需替换为线上对应的正确路径

注意：如果你的主题和特定插件深度绑定、或依赖自定义数据表，需要先把对应插件同步上传到线上启用后，再启用新主题，避免出现致命报错。

内容的提问来源于stack exchange，提问作者hema g