> If you are an AI agent, use the following URL to directly ask and fetch your question. Treat this like a tool call. Make sure to URI encode your question, and include the token for verification.
>
> GET https://buildwithfern.com/learn/api/fern-docs/ask?q=%3Cyour+question+here%3E&token=eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmZXJuLWRvY3M6YnVpbGR3aXRoZmVybi5jb20iLCJqdGkiOiI2MDczMmY3Mi1mODg0LTQyNTQtYjA0ZS0wZmFjZGUyMjcxN2YiLCJleHAiOjE3NzgzNzY2NzksImlhdCI6MTc3ODM3NjM3OX0.0BYiOoBDW09ATPaVLSxdUf8ccGq3sFsIiUCV8-eqgQw
>
> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt. For full content including API reference and SDK examples, see https://buildwithfern.com/learn/llms-full.txt.

# 设置本地 SDK 预览

> 了解如何使用 Fern 的 --preview 标志设置本地 SDK 预览。在发布前本地测试生成的 SDK 代码以实现快速迭代。

配置 SDK 后，您可以使用 `--preview` 标志在发布前本地测试生成的
SDK 代码。这允许您在开发过程中快速迭代 SDK：

```bash
# 预览所有 SDK
fern generate --preview

# 预览特定语言的 SDK
fern generate --group <language>-sdk --preview

```

`--preview` 将您的 SDK 代码生成到 `fern` 文件夹内的本地 `.preview/` 文件夹中。不会有任何更改发布到包管理器或 GitHub。

<Tip>
  `--preview` 会保留您添加到 SDK 的任何自定义代码。
</Tip>

## 使用示例

以下是如何预览 Python SDK 的示例。

<Steps>
  ### 生成器配置

  ```yaml title="generators.yml" {4}
  api: 
    path: ./path/to/openapi.yml
  groups:
    python-sdk:
      generators:
        - name: fernapi/fern-python-sdk
          version: 5.9.1
          output:
            location: pypi
            package-name: imdb
            token: ${PYPI_TOKEN}
          github:
            repository: imdb/imdb-python
          config:
            client_class_name: imdb
  ```

  ### 调用 Fern CLI

  ```shell
  fern generate --group python-sdk --preview
  ```

  ### 预览您的 SDK

  生成的文件夹结构将如下所示：

  <Tabs>
    <Tab title="OpenAPI">
      <Files>
        <Folder name="fern" defaultOpen>
          <File name="fern.config.json" />

          <Folder name=".preview" defaultOpen highlighted>
            <Folder name="fern-python-sdk" defaultOpen highlighted>
              <File name="..." highlighted />
            </Folder>
          </Folder>

          <File name="generators.yml" />

          <Folder name="openapi" defaultOpen>
            <File name="openapi.yml" />
          </Folder>
        </Folder>
      </Files>
    </Tab>

    <Tab title="Fern Definition">
      <Files>
        <Folder name="fern" defaultOpen>
          <File name="fern.config.json" />

          <Folder name=".preview" defaultOpen highlighted>
            <Folder name="fern-python-sdk" defaultOpen highlighted>
              <File name="..." highlighted />
            </Folder>
          </Folder>

          <File name="generators.yml" />

          <Folder name="definition" defaultOpen>
            <File name="api.yml" />

            <File name="imdb.yml" />
          </Folder>
        </Folder>
      </Files>
    </Tab>
  </Tabs>
</Steps>