# @fluixi/router 中文文档

规范地址：https://npmcn.com/package/%40fluixi/router/

版本：1\.0\.0-alpha\.108
npm 元数据更新时间：2026-11-07T01:10:54.430Z
中文译文更新时间：2026-11-15T02:17:12.995Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fluixi/router
原文对照：https://npmcn.com/package/%40fluixi/router/?lang=original
项目主页：https://github.com/fluixi/core#readme
源码仓库：https://github.com/fluixi/core

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：100 kB，29 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-10T03:17:08.473Z
- 最新版本发布：2026-11-07T01:08:38.728Z
- 近 30 天下载量：5955（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

Fluixi的框架-不可知路由器核心——URL到一个已解决的匹配树+导航.

## 安装

```sh
npm install @fluixi/router
```

也可以使用：`pnpm add @fluixi/router`、`yarn add @fluixi/router`、`bun add @fluixi/router`

## README

![Fluixi](https://raw.githubusercontent.com/fluixi/assets/main/logos/128x128.png)

# @fluixi/路由器

**框架-不可知路由器核心: URL → 一个已解决的匹配树 + 导航.**

[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](https://npmcn.com/package/%40fluixi/router/LICENSE) ![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white) [![npm](https://img.shields.io/npm/v/@fluixi/router?logo=npm)](https://www.npmjs.com/package/@fluixi/router) ![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)

* * *

## \* 概览

`@fluixi/router` 路径 **核心项目**: 纯状态和a `subscribe` API,与 **没有 反应, 没有 DOM, 没有视图框架**。查看适配器(Fluixi适配器位于 [`@fluixi/core/router`](https://npmcn.com/package/%40fluixi/core)使匹配树 **从上而下**,这就 深层嵌入式布局/外出制作工程。 见 [设计](https://npmcn.com/package/%40fluixi/router/DESIGN.md)。 。 。 .

## \* 安装

```sh
pnpm add @fluixi/router
```

## 使用量

```ts
import { createRouter, createMemoryHistory } from '@fluixi/router';

const routes = [
  { path: '/app', component: AppLayout, children: [
    { path: '/app/home', component: HomePage },
    { path: '/app/user/:id', component: UserPage },
  ]},
];

const router = createRouter({ routes, history: createMemoryHistory('/app/home') });

router.state().match;        // { matched: [AppLayout, HomePage], params, pathname }
router.subscribe((s) => render(s.match));
router.navigate('/app/user/42');
router.state().match.params; // { id: '42' }
```

## • API

| 导出 | 什麽 |
| --- | --- |
| `matchRoutes(routes, pathname)` | 纯匹配者 □ `RouteMatch | null` |
| `createRouter({ routes, history, base? })` | `Router` 与 `state()`, (中文(简体) ), `subscribe()`, (中文(简体) ), `navigate()`, (中文(简体) ), `match()`, (中文(简体) ), `destroy()` |
| `createMemoryHistory(initial?)` 编号 : `createBrowserHistory()` | 可插入历史适配器 |

## \* 招标合同

`match.matched` 父亲 儿子 适配器从最深的小孩向上折叠, 将每个孩子传给父母,作为父母的出路:所有的具体价值, 从来没有推迟建造。 这种自上而下的组成 使得我们深陷其中 `<Outlet/>` 在任何深度进行工作.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40fluixi/router/LICENSE) © [风花](https://fluixi.dev/)

## 常见问题

### @fluixi/router 是什么？

Fluixi的框架-不可知路由器核心——URL到一个已解决的匹配树\+导航\.

### 如何安装 @fluixi/router？

在项目目录运行 npm install @fluixi/router，或使用 pnpm add / yarn add / bun add。

### @fluixi/router 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fluixi/router 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @fluixi/router 可以商用吗？

@fluixi/router 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fluixi/router 的下载量有多少？

根据 npm 官方下载统计，@fluixi/router 在 2026/10/15 – 2026/11/13 这 30 天内被下载 5,955 次，日均约 199 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fluixi/router 还在维护吗？

最新版本 1\.0\.0-alpha\.108 发布于 2026/11/07（8 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。