# 手动导入

如果你之前使用过其他工具，现在想要迁移到 Apifox，可以使用 **手动导入**。手动导入是指将外部数据文件即时导入到当前项目中，与「定时导入」的周期性自动同步形成区分。

若要通过导入创建新项目，请在 **主窗口** 中选择团队，进入 **「团队项目」**，然后点击 **「导入项目」**。详见[新建 API 项目](https://docs.apifox.com/create-api-project.md)。

## 如何手动导入

<Steps>
  <Step>
进入 **「项目设置 → 导入数据」** 面板。

<Background>

![CleanShot 2025-11-21 at 15.56.02@2x.png](https://api.apifox.com/api/v1/projects/5097254/resources/686852/image-preview "CleanShot 2025-11-21 at 15.56.02@2x.png")

</Background> 
</Step>
<Step>
选择你需要导入的数据格式。 
</Step> 
<Step>
按照指引上传文件或填入必要的信息。 
</Step> 
<Step>
根据所选格式和项目类型，完成预览与确认。

<Background>
![CleanShot 2025-11-21 at 15.58.59@2x.png](https://api.apifox.com/api/v1/projects/5097254/resources/686843/image-preview "CleanShot 2025-11-21 at 15.58.59@2x.png")

</Background>
:::highlight purple
了解更多[导入选项](https://docs.apifox.com/import-settings.md)。导入 OpenAPI / Swagger 时的选项说明，见[导入 OpenAPI/Swagger](https://docs.apifox.com/import-openapi-swagger.md)。
::: 
</Step>
<Step>
完成导入。 
</Step> 
</Steps>

采用 **「以 OpenAPI 文件维护接口」**（简称 spec 模式）的项目，其导入行为取决于项目的存储方式：

- 对于 Apifox 存储托管的 spec 模式项目，导入的 OpenAPI / Swagger 文档会保存为规范文件，并解析该文件以更新生成后的接口结构。此路径不会出现可视化导入中的预览和导入选项。
- Git 托管的 spec 模式项目，导入的文档会按 Git 仓库的规范管理，不会写入 `reference/openapi.*` 文件。

详见[以 OpenAPI 文件维护接口](https://docs.apifox.com/9330582m0.md)。

## 导入入口

在 Apifox 中，有多个导入入口：

* 在项目 **「左侧目录树」** 中，点击 **「➕」→「导入」**。

<Background>
<img src="https://api.apifox.com/api/v1/projects/5097254/resources/595999/image-preview" width="460px"/>
</Background>

* 在项目页面左侧边栏中，进入 **「项目设置 → 导入数据」**。

<Background>
![CleanShot 2025-11-21 at 15.56.02@2x.png](https://api.apifox.com/api/v1/projects/5097254/resources/686855/image-preview "CleanShot 2025-11-21 at 15.56.02@2x.png")
</Background>

* 若要通过导入创建新项目，请在 **主窗口** 中选择团队，进入 **「团队项目」**，然后点击 **「导入项目」**。导入 OpenAPI / Swagger 时，需要选择 **「以可视化界面维护接口」** 或 **「以 OpenAPI 文件维护接口」**。该入口用于创建新项目，不属于本文所述的项目内手动导入。

<Background>
![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/493124/image-preview "image.png")
</Background>


:::tip[最佳实践]
[Apifox 中自动化测试的测试场景如何批量导入和导出？](https://apifox.com/blog/how-to-batch-import-and-export-test-scenarios/)
:::

