From e9aca9edde6a313589080e7289b301977db98337 Mon Sep 17 00:00:00 2001
From: Whbbit1999 <60510247+Whbbit1999@users.noreply.github.com>
Date: Thu, 9 Oct 2025 19:47:45 +0800
Subject: [PATCH] docs(zh/typed-routes): Sync translation of typed-routes page.
 (#2564)

The current Chinese version of typed-routes is somewhat outdated. This
commit synchronizes the translation of this file with the latest content
from the English version.
---
 .../docs/zh/guide/advanced/typed-routes.md    | 76 +++++++++++++++++--
 1 file changed, 71 insertions(+), 5 deletions(-)

diff --git a/packages/docs/zh/guide/advanced/typed-routes.md b/packages/docs/zh/guide/advanced/typed-routes.md
index 8cb7edcf..6600b9b5 100644
--- a/packages/docs/zh/guide/advanced/typed-routes.md
+++ b/packages/docs/zh/guide/advanced/typed-routes.md
@@ -1,11 +1,77 @@
-# 类型化路由 (v4.1.0+)
+# 类型化路由 <Badge type="tip" text="v4.4.0+" />
 
 <RuleKitLink />
 
-::: danger ‼️ 实验性功能
+![RouterLink to autocomplete](https://user-images.githubusercontent.com/664177/176442066-c4e7fa31-4f06-4690-a49f-ed0fd880dfca.png)
 
-从 v4.1.0 开始，我们引入一个新的功能，称为类型化路由。这个**实验性**功能通过 Vite/webpack/Rollup 插件启用。
+可以为路由配置一个类型化的映射表。 虽然可以手动实现，但更推荐使用 [unplugin-vue-router](https://github.com/posva/unplugin-vue-router) 插件来自动生成路由及其类型。
 
-![RouterLink to autocomplete](https://user-images.githubusercontent.com/664177/176442066-c4e7fa31-4f06-4690-a49f-ed0fd880dfca.png)
+## 手动配置
+
+以下是一个手动配置类型化路由的示例：
+
+```ts
+// 要为你的路由添加类型，需要从 vue-router 导入 `RouteRecordInfo` 类型
+import type { RouteRecordInfo } from 'vue-router'
+
+// 定义一个路由的 interface
+export interface RouteNamedMap {
+  // 每一个键都是一个名称
+  home: RouteRecordInfo<
+    // 这里我们的名称是相同的
+    'home',
+    // 这是路径，它会出现在自动补全中
+    '/',
+    // 这些是原始参数（可以传递给 router.push() 和 RouterLink 的 "to" 属性）
+    // 在这种情况下，不允许有任何参数
+    Record<never, never>,
+    // 这些是标准化后的参数（即通过 `useRoute()` 获取到的参数）
+    Record<never, never>,
+    // 这是一个所有子路由名称的联合类型，而在本例中，没有子路由
+    never
+  >
+  // 对每一条路由都要重复这个步骤……
+  // 注意，你可以随意为它们命名
+  'named-param': RouteRecordInfo<
+    'named-param',
+    '/:name',
+    { name: string | number }, // 允许是字符串或数字
+    { name: string }, // 但从 URL 获取时始终为字符串
+    'named-param-edit'
+  >
+  'named-param-edit': RouteRecordInfo<
+    'named-param-edit',
+    '/:name/edit',
+    { name: string | number }, // 我们还需要包含父级路由的参数
+    { name: string },
+    never
+  >
+  'article-details': RouteRecordInfo<
+    'article-details',
+    '/articles/:id+',
+    { id: Array<number | string> },
+    { id: string[] },
+    never
+  >
+  'not-found': RouteRecordInfo<
+    'not-found',
+    '/:path(.*)',
+    { path: string },
+    { path: string },
+    never
+  >
+}
+
+// 最后，你需要把这份路由映射表扩展到 Vue Router 的类型定义中
+declare module 'vue-router' {
+  interface TypesConfig {
+    RouteNamedMap: RouteNamedMap
+  }
+}
+```
+
+::: tip
+
+这种方式确实繁琐且容易出错。正因如此，强烈推荐使用 [unplugin-vue-router](https://github.com/posva/unplugin-vue-router) 来自动生成路由和类型。
 
-[查看 v4.1 版本的发布说明](https://github.com/vuejs/router/releases/tag/v4.1.0) 获取有关此功能的更多信息。[查看插件](https://github.com/posva/unplugin-vue-router) 的 GitHub 仓库获取安装说明和文档。
+:::
-- 
2.47.3