wordpress 主题本地到服务器上线全流程：迁移+数据库+固定链接，从零到线上

“wordpress 本地怎么搬到服务器？””搬家后样式丢了 / 文章 404 怎么办？”——这是用 WP 建站时最高频的两个问题。有个客户在本地把主题调得漂漂亮亮，传上服务器后前台全乱、点文章就 404，查了半天才发现是数据库里还写着 localhost/wordpress 的旧地址、固定链接没重设。这正是多数”本地能跑、线上崩”的时刻：搬家不是传文件就完事。本文把从本地到上线的每一步拆开讲，顺手把最高频的报错列了排查办法。

一、上线前本地准备

• 本地环境：PHP 7.4-8.2（服务器尽量同版本，避免函数差异）、MySQL 5.7+。
• 整理：确认主题、插件、媒体库都齐；清理测试文章和无用插件，减小迁移包。
• 受益人视角：本地收拾干净，等于给你的运维同事留了一条”线上不返工”的路。

二、文件怎么打包上传

1. 打包：本地将整个 WordPress 目录（含 wp-content 主题/插件/上传）打成 zip。
2. 传服务器：宝塔 → 站点根目录，上传并解压（或先传再解压更快）。
3. 权限：wp-content/uploads 赋可写权限，否则媒体无法上传。

三、数据库怎么迁移（最容易错的一关）

1. 本地导出：phpMyAdmin → 导出整库 SQL（或用 WP 迁移插件生成包）。
2. 服务器建库导入：服务器新建数据库，导入 SQL；若导入报错多为版本不匹配或文件过大（改 upload_max_filesize 或用命令行导入）。
3. 改站点地址（关键）：导入后，到 wp_options 表把 siteurl 和 home 改成服务器真实域名——漏这步，前台全走老地址、样式必丢。
4. 配置文件：改 wp-config.php 填新库名 / 账号 / 密码 / 主机。

四、固定链接与伪链接（防 404）

• 后台 → 设置 → 固定链接，选”文章名”等美观结构；若文章页 404，是服务器伪静态没开。
• Nginx：加 WordPress 标准 rewrite 规则（将请求重写到 index.php）；Apache：确保 .htaccess 存在且生效（开启 AllowOverride All）。
• 改完固定链接务必再保存一次，触发规则刷新。

五、常见报错排查（样式丢 / 404 / 打不开）

• 样式丢失 / 图片裂：几乎都是 siteurl/home 还是本地地址 → 改 wp_options 两项为新域名，并批量替换文章内容里的旧地址（可用”搜索替换”插件）。
• 文章 404：伪静态没配或固定链接未重设 → 配 Nginx/Apache 规则并保存固定链接。
• 数据库导入报错：版本不匹配或 SQL 过大 → 用命令行 mysql 导入，或分卷导出。
• 白屏：插件冲突或内存不足 → 临时改名 wp-content/plugins 排查，或调高 memory_limit。

六、上线前验证清单

• [ ] 前台样式正常（非本地旧地址）
• [ ] 文章 / 页面点击不 404
• [ ] 媒体库可上传（uploads 有权限）
• [ ] 固定链接生效、伪静态已配
• [ ] 插件 / 主题均正常启用
• [ ] 后台可登录并编辑

七、为什么”线上能跑”比”本地好看”重要

WordPress 不是本地调美就结束。一套迁移文档清晰、地址配置正确、伪静态就绪的交付，才让访客真正访问得到——这也是专业源码站和”本地玩具”的分界线。卓创系统搭建交付的每套 WP 主题 / 源码，都附带迁移说明和一条龙部署，零基础也能照着上线。

---

📦 需要带完整迁移文档、环境说明的 WordPress 主题 / 源码？在卓创源码网（zhuochuangyun.cn）浏览对应栏目，或直接看 {{下载页链接}}。 🔗 相关：企业官网选 pbootcms 还是 WordPress？见 {{对比评测链接}}。

{ “@context”: “https://schema.org”, “@type”: “FAQPage”, “mainEntity”: [ { “@type”: “Question”, “name”: “wordpress 本地怎么搬到服务器？”, “acceptedAnswer”: { “@type”: “Answer”, “text”: “四步：1）本地打包整站（含 wp-content）；2）上传服务器站点根目录并解压、给 uploads 赋权；3）导出本地数据库，服务器建库导入，改 wp-config.php；4）改 wp_options 的 siteurl/home 为新域名，并配伪静态。漏掉地址替换，前台必丢样式。” } }, { “@type”: “Question”, “name”: “wordpress 搬家后样式丢了 / 图片裂怎么办？”, “acceptedAnswer”: { “@type”: “Answer”, “text”: “几乎都是数据库里 siteurl/home 还是本地旧地址。到 wp_options 表把这两项正确改成服务器域名，并用’搜索替换’插件批量替换文章/媒体里的旧地址。改完前台即恢复。” } }, { “@type”: “Question”, “name”: “wordpress 迁移后文章 404 怎么解决？”, “acceptedAnswer”: { “@type”: “Answer”, “text”: “多为伪静态未配或固定链接未重设。Nginx 加 WordPress 标准 rewrite 规则（重写到 index.php），Apache 确保 .htaccess 存在且 AllowOverride All；后台设置→固定链接保存一次触发刷新。” } }, { “@type”: “Question”, “name”: “wordpress 数据库导入报错怎么办？”, “acceptedAnswer”: { “@type”: “Answer”, “text”: “常见原因：SQL 文件过大（改 upload_max_filesize 或用命令行 mysql 导入）、MySQL 版本不匹配。命令行导入最稳：mysql -u 用户 -p 库名 < 文件.sql。导入前确认服务器库字符集与本地一致（utf8mb4）。" } }, { "@type": "Question", "name": "wordpress 上线用什么 PHP 版本？", "acceptedAnswer": { "@type": "Answer", "text": "推荐 PHP 7.4 或 8.0-8.2（视主题/插件兼容）。服务器尽量与本地同版本，避免函数差异导致白屏。老旧主题若有废弃函数，先在本地升 PHP 测一轮再迁移。" } } ] }