概述

通过命令行管理和配置您的 Fern 项目。

以 Markdown 格式查看

Fern CLI 让您能够初始化项目、验证 API 定义、在本地预览更改,以及发布文档和 SDK。本页介绍安装和常用命令,帮助您快速入门。

安装

1

检查先决条件

Fern CLI 需要 Node.js 版本 22 或更高版本,以及 npm 版本 10.0.0 或更高版本(随 Node.js 22 一起发布)。

$node -v # 必须是 v22.0.0 或更高版本

如果您的版本低于最低要求,请下载最新的 Node.js LTS,它包含兼容的 npm 版本。

2

安装 Fern CLI

运行以下命令从 npm 全局安装 Fern CLI:

$npm install -g fern-api
$fern -v # 验证安装

如果您希望将 Fern 作为项目依赖项管理,或者在网络连接有限的环境中工作,可以本地安装 CLI:

1

作为项目依赖项安装

$npm install fern-api
2

更新配置

在您的 fern.config.json 中,将版本设置为 * 以使用本地安装的版本:

fern.config.json
1{
2 "organization": "your-org",
3 "version": "*"
4}

有关更多详细信息,请参阅 fern.config.json 参考

3

通过包管理器运行

$npm fern check
$npm fern generate

按产品分类的 CLI 工作流程

Fern CLI 管理文档和 SDK 工作流程。以下是每个产品常用命令的简要概述。所有命令都支持全局选项,如用于调试的 --log-level

有关完整的 CLI 文档,请参阅命令参考

在使用 Fern Docs 时,您将使用这些 CLI 命令。有关完整说明,请参阅文档快速入门

命令描述
fern init --docs创建新的文档项目
fern docs devlocalhost:3000 本地预览文档
fern generate --docs将文档发布到生产环境

在使用 Fern SDK 时,您将使用这些 CLI 命令。有关完整说明,请参阅SDK 快速入门

命令描述
fern init创建新的 SDK 项目
fern check验证您的 API 定义
fern generate --preview.preview/ 中本地预览 SDK
fern generate将 SDK 发布到生产环境
fern generate --group <name>生成特定的 SDK 组