Skip to content

IDE 设置

EasyYapi 提供了 IDE 级别的设置,可以在 IDEA 中进行配置。

打开设置

Settings > Other Settings > EasyApi

通用设置

设置项说明
postman.urlPostman 导出 URL
postman.tokenPostman API Token
yapi.serverYApi 服务器地址
yapi.tokenYApi 项目 Token
project.name项目名称

导出设置

设置项说明
outputDemo导出 Markdown 时生成响应 demo
outputCharset导出字符集

框架开关

设置项说明默认值
feignEnable启用 Feign 客户端支持false
jaxrsEnable启用 JAX-RS 支持true
actuatorEnable启用 Spring Actuator 支持false
grpcEnable启用 gRPC 支持true
swaggerEnable启用 Swagger 支持true
swagger3Enable启用 Swagger 3 / OpenAPI 支持true

推荐配置

EasyYapi 内置了推荐配置,可以在设置中启用。推荐配置包含常用的规则和类型转换。

Features 标签页

EasyYapi 3.2 使用 Features 标签页统一管理扩展点的启用状态。列表会根据已安装的插件组件动态生成:

分区控制内容
Framework SupportFeign、JAX-RS、Actuator、gRPC 和 Custom 等框架识别器。
Export ChannelsYApi、Postman、Markdown、cURL、HttpClient、Hoppscotch (Beta) 和 OpenAPI (Beta) 等导出渠道。实验性渠道默认关闭。
Field Format ChannelsJSON、JSON5、Properties、YAML 等字段格式化渠道。

大部分框架识别器、导出渠道、字段格式化渠道和扩展配置都可以在 Settings 中启用或关闭。General 标签页还提供 API 扫描、自动/并发扫描和编辑器行标记等开关。

General 标签页中的 Enable API scanning 是 API 发现的总开关。关闭后,自动扫描、并发扫描和 API 行标记都会被关闭。

cURL

cURL 设置页控制变量渲染,以及批量导出和 Dashboard Copy as cURL 使用的默认值:

设置项说明
Render mode保留占位符、使用当前环境解析,或每次导出询问。环境值优先于配置读取器的值。
Copy from edited复制 cURL 时使用 Dashboard 中编辑后的接口,而不是源代码接口。
Include comments and section dividers在批量脚本中添加接口标题和分隔线。
Pretty-print JSON body为 JSON 请求体添加缩进。
Multi-line format每行输出一个 cURL 参数。
Long flags使用 --request--header--data--form 等长参数名。
Response example将可用的响应体示例追加为注释。
Run pre-request scripts批量导出执行文件夹/类脚本,单接口复制还会执行接口级脚本。

导出对话框可以针对单次导出覆盖格式化和请求前脚本选项。

OpenAPI (Beta)

OpenAPI 导出默认关闭。通过 Features 启用后,OpenAPI 设置页可以选择 JSONYAMLAsk each export。默认文件名为 openapi.jsonopenapi.yaml

文档级元数据通过 openapi.info.titleopenapi.info.versionopenapi.info.descriptionopenapi.server.url 规则配置,也兼容旧的 openapi.host。详见导出到 OpenAPI

Custom 框架

Custom 框架默认关闭,可以在 Features > Framework Support 中启用。它提供可选的行标记开关;实际接口提取由 custom.* 规则控制。详见 Custom 框架

基于 Apache-2.0 许可发布