项目结构

在使用 Fern 生成 SDK 之前，需要设置正确的 GitHub 仓库结构来存放您的 API 定义和 SDK 代码，这样您和您的用户可以直观地访问、维护和更新代码。

仓库架构

Fern 建议使用多仓库结构，包含：

• 源仓库：包含您的 API 定义和 SDK 生成配置
• SDK 仓库：每个 SDK 一个仓库（TypeScript、Python、Go 等）

这种分离方式允许您集中管理 API 定义，同时将每个 SDK 保持在自己的仓库中，实现独立的版本管理和分发。

核心配置文件

源仓库包含一个 fern/ 文件夹，其中初始化了您的 API 定义和顶级 generators.yml 文件。

fern.config.json

fern.config.json 文件存储您的组织名称和 Fern CLI 版本。固定版本提供确定性构建。

{
  "organization": "plant-catalog",
  "version": "5.23.3"
}

generators.yml

generators.yml 文件在 api.specs 部分声明您的 API 规范位置，并在 groups 部分配置 SDK 生成。

# API 声明
api:
  specs:
    - openapi: ./openapi/openapi.yml
# SDK 生成
groups:
  ts-sdk:
    generators:
      - name: fern-typescript-sdk
        version: 3.98.0
        github:
          repository: your-organization/typescript-sdk-repo
  python-sdk:
    generators:
      - name: fern-python-sdk
        version: 5.33.2
        github:
          repository: your-organization/python-sdk-repo

完整的配置选项请参阅 generators.yml 参考页。

API 定义文件

有关组织 API 定义文件和处理多个 API 的详细信息，请参阅项目结构（API 定义）。