Insomnia团队协作需通过Git同步、Git凭证配置、日常同步操作、共享工作区直连及JSON导出导入五种方式实现统一。启用Git同步将API资源版本化；配置Git凭证确保权限有效；日常执行Commit/Pull/Push保障变更一致；共享工作区支持实时协作者同步；离线场景可用加密JSON文件交换完整API资产。

如果您在团队中使用Insomnia开发API，但多个成员的请求集合、环境配置或测试用例无法保持一致，则可能是由于缺乏统一的同步机制。以下是实现团队协作同步的具体操作路径：

一、启用Git同步功能

Git同步将Insomnia项目映射为标准Git仓库结构，使所有API资源（如请求、环境、插件配置）以可版本化文件形式存储，便于多人协同编辑与历史追溯。

1、启动Insomnia客户端，打开需共享的API工作区。

2、点击顶部菜单栏的Git图标，或通过File → Git Sync进入同步设置界面。

3、选择Initialize Git Repository，浏览并指定本地项目根目录（建议与已有Git仓库根目录一致）。

4、在弹出窗口中填写远程仓库URL，格式为https://gitcode.com/用户名/仓库名.git或SSH地址。

5、点击Initialize完成初始化，此时项目文件夹内将生成.git目录及Insomnia专用的insomnia.*.json资源文件。

二、配置Git凭证与身份认证

Insomnia需凭据访问远程Git仓库执行Push/Pull操作，凭证信息决定提交作者标识与权限有效性，避免因认证失败导致同步中断。

1、点击右上角用户头像，选择Settings，切换至Credentials选项卡。

2、点击Create Git Credential，选择Access Token方式。

3、依次填入：Author Email（如team@domain.com）、Author Name（如API-Team）、Username（Git平台登录名）、Git Access Token（从Git平台个人设置中生成的token）、Base URL（如https://gitcode.com/api/v1）。

4、点击Save Credential，系统立即验证连接状态并显示绿色对勾标记。

三、执行日常同步操作

团队成员通过标准化Git操作保障本地修改与远程主干实时对齐，避免覆盖冲突或丢失变更，每次同步均生成可审计的提交记录。

1、修改请求参数、新增环境变量或调整工作区结构后，点击Git面板中的Commit按钮。

2、在提交弹窗中输入清晰描述（如“更新支付网关测试环境URL”），勾选待提交的文件，点击Commit。

3、开始协作前，先点击Pull拉取远程最新提交，Insomnia自动合并非冲突变更。

4、确认本地无未提交更改后，点击Push将本次提交推送至远程仓库主分支。

四、使用共享工作区直连协作

Insomnia支持基于云服务的实时工作区共享，无需手动管理Git分支，适用于快速迭代场景或Git权限受限的团队环境。

1、在左侧导航栏点击Workspaces，选择当前工作区右侧的⋯菜单。

2、点击Share Workspace，输入合作者邮箱地址，从下拉列表中选择对应权限级别：Viewer（仅查看）、Editor（可编辑）、Admin（可管理成员）。

3、点击Send Invite，受邀成员将在Insomnia通知中心收到链接，点击后自动加载该工作区全量数据。

4、所有成员对同一工作区的修改将在5秒内实时同步，响应区顶部显示当前在线协作者头像缩略图。

五、导出导入JSON实现离线协作

当团队成员无法接入Git或云服务时，可通过结构化JSON文件交换完整API资产，确保核心测试逻辑与参数配置不丢失。

1、在工作区右键菜单中选择Export Workspace，格式选择Insomnia v4 (JSON)。

2、保存文件命名为api-collection-team-v2.json，通过加密邮件或内部网盘分发给其他成员。

3、接收方在Insomnia中点击左上角+ → Import Data，选择该JSON文件。

4、导入完成后，新工作区自动包含全部请求、环境、认证凭据（敏感字段默认加密，需手动解密输入密码）。