Next.js静态导出做企业官网

之前踩过这个坑，花了不少时间才解决。把关键步骤整理出来，核心代码都贴上了，直接拿去用就行。

先搞清楚原理

Next.js的基本概念其实不复杂。关键在于理解性能瓶颈这个环节。看下面这段代码，逻辑就很清楚了：

<?php
function register_blog_post_type() {
    register_post_type('blog', array(
        'labels' => array(
            'name' => 'blog管理',
            'singular_name' => 'blog',
        ),
        'public' => true,
        'has_archive' => true,
        'rewrite' => array('slug' => 'blogs'),
        'supports' => array('title', 'editor', 'thumbnail', 'excerpt'),
        'menu_icon' => 'dashicons-admin-page',
        'show_in_rest' => true,
    ));
}
add_action('init', 'register_blog_post_type');

add_action('rest_api_init', function() {
    register_rest_route('custom/v1', '/blogs', array(
        'methods' => 'GET',
        'callback' => 'get_blogs',
        'permission_callback' => '__return_true',
    ));
});

function get_blogs(WP_REST_Request $request) {
    $args = array(
        'post_type' => 'blog',
        'posts_per_page' => (int) $request->get_param('per_page') ?: 10,
        'paged' => (int) $request->get_param('page') ?: 1,
    );
    $query = new WP_Query($args);
    return rest_ensure_response($query->posts);
}

实际怎么用

在真实项目中用Next.js，和教程里还是有区别的。主要是性能瓶颈这块需要额外处理。完整代码如下：

<?php
function custom_meta_description_59() {
    if (is_single()) {
        global $post;
        $excerpt = get_the_excerpt($post);
        $desc = mb_substr(wp_strip_all_tags($excerpt), 0, 155);
        echo '<meta name="description" content="' . esc_attr($desc) . '">' . "\n";
    }
}
add_action('wp_head', 'custom_meta_description_59', 1);

function add_schema_markup_59() {
    if (is_single()) {
        global $post;
        $schema = array(
            '@context' => 'https://schema.org',
            '@type' => 'Article',
            'headline' => get_the_title($post),
            'datePublished' => get_the_date('c', $post),
            'dateModified' => get_the_modified_date('c', $post),
        );
        echo '<script type="application/ld+json">' . wp_json_encode($schema, JSON_UNESCAPED_UNICODE) . '</script>' . "\n";
    }
}
add_action('wp_head', 'add_schema_markup_59', 99);

进阶一点的用法

如果对性能有要求，Next.js可以做性能瓶颈方面的优化。核心改动不大，但效果明显：

容易踩的坑

用Next.js的时候有几个常见的错误写法。比如性能瓶颈没有正确处理，或者缓存策略设计的顺序搞反了。下面列出几个典型问题和修复方式。

写在最后

整体来看，Next.js用起来不算复杂，关键是理解缓存策略设计这个核心机制。建议先跑通基础示例，再逐步加功能。有问题可以看官方文档，社区也比较活跃。