当前位置：首页 > 文章列表 > 文章 > 前端 > Next.js动态路由与SSG实战解析

Next.js动态路由与SSG实战解析

2026-03-29 18:41:26 0浏览收藏

本文深入解析了Next.js中如何通过getStaticPaths和getStaticProps协同实现动态路由与静态站点生成（SSG），手把手演示了从创建/pages/posts/[id].js动态路由文件，到预获取所有有效路径、按需拉取单条数据并注入页面的完整流程；不仅确保了极致的加载性能和出色的SEO表现，还兼顾了大规模动态内容（如博客文章、商品详情）的可维护性与可扩展性，是构建高性能现代Web应用不可或缺的核心实践。

如何用Next.js实现动态路由与静态生成？

在Next.js中实现动态路由与静态生成，关键在于结合getStaticPaths和getStaticProps这两个函数。这种方式既支持SEO友好的预渲染，又能处理大量动态内容。

创建动态路由文件

在pages目录下，使用方括号创建动态路由文件。例如，要展示不同文章的页面，可以创建：

/pages/posts/[id].js

这里的[id]就是动态参数，访问/posts/1或/posts/2都会匹配这个页面。

使用 getStaticPaths 预生成路径

这个函数告诉Next.js在构建时应该为哪些动态路径生成HTML页面。

示例代码：

export async function getStaticPaths() {
  const res = await fetch('https://api.example.com/posts');
  const posts = await res.json();

  const paths = posts.map((post) => ({
    params: { id: post.id.toString() },
  }));

  return { paths, fallback: false };
}

注意：当fallback设为false时，只有paths中包含的路径会被生成，其他路径会返回404。

使用 getStaticProps 获取数据

这个函数在构建时被调用，用于获取每个页面所需的数据。

示例代码：

export async function getStaticProps({ params }) {
  const res = await fetch(`https://api.example.com/posts/${params.id}`);
  const post = await res.json();

  return { props: { post } };
}

这样，在页面组件中就可以直接通过props使用post数据了。