# @fluixi/cli 中文文档

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

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

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

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

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

- 包体积（解压后）：503 kB，79 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：typescript \>=5\.0\.0
- 首次发布：2026-07-10T03:16:59.261Z
- 最新版本发布：2026-11-07T01:08:31.409Z
- 近 30 天下载量：2222（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

这个 `fluixi` 命令行工具——dev/building/start(通过@fluixi/start),以及后来的脚手架+发电机.

## 安装

```sh
npm install @fluixi/cli
```

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

## README

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

# 校对:soup

**这个 `fluixi` 命令行工具:dev / 构建 / 启动 + 代码生成器.**

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

* * *

## \* 概览

`@fluixi/cli` 提供 `fluixi` 二进制: 一个薄薄的调度器结束 [`@fluixi/start`](https://npmcn.com/package/%40fluixi/start) (框架运行时间)加发电机。 一个脚手架应用程序 已经包括了.

```bash
fluixi dev                    # SSR dev server (Vite middleware + HMR)
fluixi build                  # client + server bundles → dist/client, dist/server
fluixi start                  # production SSR server (after build)
fluixi generate <kind> <name> # scaffold into the current app (alias: g)
fluixi check [--strict]       # env and auth rules over the project; exit 1 on an error
fluixi env                    # env.public set or not, .env.example drift, secrets that would ship
fluixi doctor                 # duplicate @fluixi/* copies, ts-plugin missing from tsconfig
fluixi info                   # versions, adapter, modules, pages, API routes
```

## \* 安装

```sh
pnpm add -D @fluixi/cli
```

## qq 生成

```bash
fluixi g component Button       # → src/components/Button.tsx
fluixi g route about            # → src/routes/about.tsx        (file route)
fluixi g route "blog/[id]"      # → src/routes/blog/[id].tsx    (dynamic segment)
fluixi g middleware             # → src/middleware.ts
fluixi g env                    # → src/config/env.ts           (pickEnv over env.public)
fluixi g module billing         # → src/services/billing/billing.module.ts, listed in src/app.config.ts
fluixi g service Orders         # → src/services/orders.ts       (class, token, module)
fluixi g service Mailer --server  # → src/services/mailer.server.ts, listed in src/app.config.server.ts
fluixi g api "users/[id]"       # → src/api/users/[id].ts
fluixi g api admin/stats --role admin  # → guarded route + src/services/verify.server.ts
fluixi g server-fn getUser      # → src/server/getUser.ts        ("use server")
fluixi g auth oauth2 --provider keycloak --tokens server
                                # → config/env.ts, services/auth.ts, login route, auth.server.ts,
                                #   env.public and .env.example entries
fluixi g auth better-auth       # → auth.config + auth.client + middleware + src/api/auth route
```

编写新文件, 除非已经存在同名文件, 在这种情况下 进程以出错而停止。 编辑仅限于 `app.config.ts`, (中文(简体) ), `app.config.server.ts` (添加进口和输入), `env.public` 内 `fluixi.config.ts`并附加到 `.env.example`; 保存每个文件的原始布局, 当导入不是 plain 列表命令打印用于手工粘贴的行 。 多文件 OAuth2 生成 保持现有文件不变.

### JSX 或 html "

扩展遵从项目:一个应用软件 `tsconfig.json` 配置 `jsx` 获得 `.tsx`,一个作者与 `html` 模板获得 `.ts`覆盖 `--jsx` 或者说 `--html`。 。 。 .

```bash
fluixi g component Button --html   # → src/components/Button.ts
```

### 使用组件而不导入

在生成一个组件后, CLI 将打印出如何不导入标记解析 , 如果项目还没有规则:

```
✓ created src/components/Card.tsx
to use <Card /> without importing it, add to vite.config.ts:
  resolve: [{ match: /^([A-Z]\w+)$/, module: '/src/components/$1.tsx' }]
```

一个图案覆盖了整个文件夹,所以你粘贴它一次,然后是每个组件 工作时 脚手架 `npm create fluixi` 已经拥有它.

CLI读取您的配置 来决定是否说这个, 并且从来没有写信给它。 一个配置 是普通的TypeScript,它可以传播共享对象或调用解析器函数,所以 编辑意味着重印你的档案 我宁愿打印你粘的行 冒险操纵它.

进口部件的工作,包括 `load:` 指令 :

```tsx
import { Card } from './components/Card';

<Card load:visible="200px" />   // still splits into its own chunk
```

## 新项目

脚手架整个应用是 [`create-fluixi`](https://npmcn.com/package/%40fluixi/create),不是CLI: :

```bash
npm create fluixi my-app      # or: pnpm create fluixi my-app
```

Dev/building/启动逻辑+配置 [`@fluixi/start`](https://npmcn.com/package/%40fluixi/start):参见其读取 b. 《公约》缔约方`src/entry-server.ts`, (中文(简体) ), `src/routes/`, (中文(简体) ), `index.html`, (中文(简体) ), `fluixi.config.ts`) (中文(简体) ).

## 许可证

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

## 常见问题

### @fluixi/cli 是什么？

这个 fluixi 命令行工具——dev/building/start\(通过@fluixi/start\),以及后来的脚手架\+发电机\.

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

在项目目录运行 npm install @fluixi/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fluixi，可以用 npx fluixi 直接运行。

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

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

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

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

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

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

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

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

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

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