如何在Docusaurus v2中处理页面移动/重命名后的链接问题？

开发者阿泽

2026-8-20

Docusaurus v2 页面结构调整后避免旧链接失效的方案

完全可以通过路由设置实现旧链接到新链接的重定向，以下是具体操作方法和注意事项：

1. 使用官方重定向插件（推荐）

Docusaurus v2 自带@docusaurus/plugin-client-redirects插件，是处理路由重定向的最优方案。

配置步骤：

在项目根目录的docusaurus.config.js中添加插件配置：

module.exports = {
  // 保留原有其他配置项
  plugins: [
    [
      '@docusaurus/plugin-client-redirects',
      {
        redirects: [
          // 单个页面重定向
          {
            from: '/old-docs/api-reference',
            to: '/new-docs/api/v2/reference',
            permanent: true, // 开启301永久重定向，利于搜索引擎更新索引
          },
          // 整个目录批量重定向
          {
            from: '/old-guides/*',
            to: '/new-guides/:match*', // :match* 匹配原路径的剩余部分
          },
        ],
      },
    ],
  ],
};

插件特点：

客户端自动跳转，用户访问旧链接会无缝跳转到新地址
支持设置永久（301）或临时（302）重定向，适配不同场景
通配符匹配支持批量处理目录级迁移，减少重复配置

2. 页面内元标签重定向（临时场景）

针对个别页面的临时调整，可在原页面位置保留空页面，通过HTML元标签实现跳转：

import React from 'react';

export default function OldPageRedirect() {
  return (
    <meta http-equiv="refresh" content="0; url=/new-page-path" />
  );
}

这种方式灵活性较低，不适合批量操作，且搜索引擎对元重定向的识别优先级低于HTTP状态码重定向。