从零搭建WordPress站点，导入JSON只需3步，避开90%的坑

找建站公司报价五万，自己动手可能只要一台云服务器。很多老板在【wordpress导入json】这一步卡壳，要么格式报错，要么数据丢失。别慌，今天拆解一个真实案例，教你【从零搭建】避坑指南。

项目背景：一个外贸独立站的“数据搬家”难题

上个月，杭州做户外装备的客户老张找到我。他之前花两万八找外包做的WordPress站点，因为功能太弱，想重新【从零搭建】。但老张手里有一份关键的JSON数据文件，里面存了200多套产品参数、图片URL和SEO元描述。

外包公司说：“这数据得重写代码，加五千块。”老张不信邪，来问我。

这就是典型的现场常见违规问题：把简单的数据导入搞成了复杂的开发需求。实际上，WordPress原生支持JSON导入，只要格式对，五分钟就能搞定。

为什么你的JSON导入总失败？三个高频坑

我在GitHub 开源仓库里翻了上百个WordPress插件代码，发现90%的导入失败源于三个问题：

编码格式错误：中文乱码是通病，文件必须是UTF-8无BOM格式。
字段映射缺失：WordPress默认导入器不识别自定义字段，需要预处理。
媒体库路径断裂：JSON里的图片URL是旧站绝对路径，新站直接导入后图片404。

老张的JSON就是栽在第二点上。他的数据里有meta_key和meta_value嵌套结构，WordPress原生导入器根本不认。

技术选型：为什么不用插件，而是写脚本？

市面上有WP All Import这类付费插件，但免费版限制多，高级版一年两千多。对于一次性导入，自己写PHP脚本更省钱、更可控。

我的思路是：

不用插件：避免兼容性问题，保持核心干净。
PHP脚本：直接操作数据库，速度快，可调试。
预校验：导入前跑一遍数据检查，避免中途报错。

这是【wordpress导入json】最稳的路径。

核心实现：一份能直接用的导入脚本

下面是我给老张写的脚本核心逻辑。别被代码吓到，注释写得很细，前端初学者也能看懂。

<?php
// wordpress-import-json.php
// 放在wp-content目录下，通过浏览器访问define('ABSPATH', dirname(__FILE__) . '/../../');
require_once(ABSPATH . 'wp-load.php');// 1. 读取JSON文件
$filePath = ABSPATH . 'uploads/product-data.json';
$jsonData = file_get_contents($filePath);if (!$jsonData) {die('文件读取失败，请检查路径');
}$data = json_decode($jsonData, true);if (json_last_error() !== JSON_ERROR_NONE) {die('JSON解析错误: ' . json_last_error_msg());
}// 2. 预处理：处理媒体路径
foreach ($data as &$item) {// 将旧站图片路径替换为新站占位符$item['image_url'] = str_replace('http://old-site.com', '', $item['image_url']);$item['image_url'] = '/wp-content/uploads/' . basename($item['image_url']);
}
unset($item);// 3. 逐条插入数据库
$successCount = 0;
$errorCount = 0;foreach ($data as $item) {// 检查是否已存在（按SKU去重）$existing = $wpdb->get_row($wpdb->prepare("SELECT ID FROM {$wpdb->postmeta} WHERE meta_key = 'sku' AND meta_value = %s",$item['sku']));if ($existing) {$errorCount++;continue; // 跳过重复数据}// 插入文章（产品作为post类型）$postId = wp_insert_post(array('post_title'   => $item['name'],'post_content' => $item['description'],'post_status'  => 'publish','post_type'    => 'product', // 假设用了WooCommerce'post_author'  => 1));if (is_wp_error($postId)) {$errorCount++;continue;}// 插入自定义字段update_post_meta($postId, 'sku', $item['sku']);update_post_meta($postId, 'price', $item['price']);update_post_meta($postId, 'image_url', $item['image_url']);// 插入SEO元数据（Yoast SEO示例）update_post_meta($postId, '_yoast_wpseo_focuskw', $item['seo_keyword']);update_post_meta($postId, '_yoast_wpseo_metadesc', $item['seo_description']);$successCount++;
}// 4. 输出结果
echo "导入完成！<br>";
echo "成功: " . $successCount . " 条<br>";
echo "失败/跳过: " . $errorCount . " 条<br>";
echo "请手动检查媒体库，重新上传图片。";// 安全：生产环境请删除此文件
?>

关键点解析：