在日常前后端开发协作中，接口 Mock 几乎是必经环节。尤其是当前端需要提前验证交互流程、而后端接口尚未提供时，一套能快速生成语义合规 Mock 数据的工具显得格外重要。Trae 提供了四种灵活方式自动生成 API Mock 数据，覆盖不同开发阶段的实际需求。下面逐一详细说明。

一、基于 Swagger/OpenAPI 文档自动生成 Mock

如果你已有现成的接口规范文档（例如 OpenAPI 3.0），这是最省力的方式。Trae 能够原生解析这类规范，自动将接口路径、请求方法、参数类型以及响应 Schema 映射为可执行的 Mock 规则。字段名称、嵌套结构、数据类型均严格匹配原始定义，几乎零误差。

具体操作步骤如下：

1. 在 Trae 主界面点击 “Import API Spec”，导入本地的 swagger.json 或 yaml 文件，也可直接粘贴 OpenAPI 文档的 URL 链接。

2. 确认文档加载成功后，Trae 会自动识别所有端点，并在右侧的 Mock 配置面板展示每个接口的请求/响应结构树。

3. 勾选 “Auto-generate mock for all endpoints”，然后点击 “Apply to Mock Server” 启动本地 Mock 服务。

4. 内置 HTTP 服务器会监听默认端口（比如 http://localhost:3001），所有接口路径自动映射。例如，GET /api/users 返回的就是符合 schema 的随机用户数组，前端可直接使用。

二、从 .har 或 CSV 日志提取真实流量并泛化为 Mock

有些场景下，你手头没有规范的接口文档，却有现成的真实流量日志——比如浏览器导出的 .har 文件，或结构化的 CSV 日志。Trae 可以从这些日志中抽取请求-响应对，经过脱敏和变量标记后，转为可复用的 Mock 样本。这样做的好处是：Mock 数据更贴近实际业务分布，甚至能覆盖异常状态码（如 404、500）。

操作路径也很简单：

1. 在 Trae 中点击 “Import Traffic Log”，导入 .har 文件或 CSV 日志。

2. 在日志列表中筛选目标 API 端点，右键选择 “Create Mock from Selected Entries”。

3. 进入泛化配置界面，为 URL 路径参数（如 /user/123）、请求头（如 Authorization）、响应体字段（如 id、createdAt）逐一设置变量规则。比如，将数字 ID 替换为 ${int(1000, 9999)}，这样每次请求都能生成不同随机值。

4. 勾选 “Preserve status code and content-type”，保存后该 Mock 条目就能按原始状态码和 Content-Type 精确响应。比如原本返回 400 的接口，Mock 也会返回 400，便于测试边界情况。

三、使用自然语言指令驱动 AI 生成语义 Mock

如果你还在接口设计早期，连像样的文档都没有，也别着急。Trae 内置的 AI 模型可以根据自然语言描述，直接推导出结构完整、逻辑自洽的 Mock JSON。你甚至可以指定复杂的嵌套结构或状态流转。

具体做法：

1. 在 Trae Mock 配置区切换到 “NL Prompt” 输入模式。

2. 输入一条明确的中文指令，例如：“生成 POST /api/orders 创建订单的失败 Mock：status=400，响应 body 包含 code 字段值为 'VALIDATION_ERROR'，message 为 'quantity must be greater than 0'，且不包含 data 字段”。

3. 点击 “Generate with AI”，等待模型返回结构化 JSON，然后仔细检查是否满足你要求的状态码、字段存在性和值约束。

4. 将生成的结果拖入对应接口的 Mock 编辑器，点击 “Deploy to Local Server” 立即生效。整个过程几乎不需要手动编写任何字段。

四、集成 Mockoon 等外部 Mock 服务动态注入

对于多前端团队协作的场景，可能需要一个集中管理的 Mock 源。Trae 可以作为控制中枢，通过 HTTP API 调用已部署的 Mockoon 实例，实现 Mock 配置的集中管理与跨环境同步。

配置步骤：

1. 在 Mockoon 中创建一个新环境并启动服务，记下它的管理 API 地址（比如 http://localhost:3002/mockoon-api）和环境 ID。

2. 在 Trae 设置中进入 “External Mock Services”，点击 “Add Service”，填写 Mockoon 的 API Base URL 和认证 Token（如果有的话）。

3. 选中 Trae 接口列表中的目标端点，右键选择 “Sync to Mockoon”，Trae 会自动将当前接口定义转换为 Mockoon 兼容的路由规则与响应模板。

4. 同步完成后，前往 Mockoon 管理界面查看新生成的路由，验证 Trae 发起的请求是否被正确拦截并返回预设的 Mock 响应。这样所有前端团队成员就能共享同一套 Mock 数据，避免各自维护带来的混乱。

总的来说，这四种方式覆盖了从文档完备到无文档、从单人调试到团队协作的各类场景。根据你当前的手头资源和团队规模，选择最适合的一种切入即可。关键是让 Mock 数据既忠于真实逻辑，又不过度复杂——Trae 在这方面做了不少取舍和优化。