Atoms 支持拦截并重写接口响应体:启用后依次定位目标请求→开启 URL 拦截→创建 overrides 文件夹→在对应路径下新建 response.json 并写入修改后的数据,保存后即可立即生效;关闭 Enable Overrides 后即可恢复原始接口返回内容。

用 Atoms 工具二次修改接口返回字段
在前端联调或接口调试阶段,如果后端暂未提供完整字段,或者需要临时补全、脱敏、重命名部分接口返回字段,可以借助 Atoms(基于 Chromium 的轻量级调试工具)直接拦截并重写响应体。这样无需修改后端代码,也不依赖 mock 服务,同时还能避免污染本地开发环境,适合快速处理接口返回数据。
启用 Atoms 并加载目标页面
下载安装 Atoms v1.8.3 或更高版本(目前仅支持 Windows/macOS),启动后打开目标 Web 应用 URL。请确保页面至少已经触发过一次需要修改的接口请求,否则后续在 Network 面板中无法准确定位该请求。
按 Ctrl+Shift+I(Windows)或 Cmd+Option+I(macOS)打开开发者工具 → 切换到「Network」标签页 → 勾选「Preserve log」以避免页面刷新后请求记录被清空。
定位并拦截目标接口请求
在 Network 请求列表中找到目标接口(例如 /api/user/profile),右键 → 选择「Block request URL」→ 在弹出框中输入精确请求路径(也支持通配符,例如 */api/user/*)→ 点击「Add」。
完成后,该接口后续的所有请求都会被拦截,Atoms 通常会自动跳转到「Overrides」面板。若未自动跳转,可手动点击左侧面板中的「Overrides」图标(三个水平线+折线图)进入。
创建本地覆盖文件夹并映射
点击 Overrides 面板右上角「⋯」→ 「Select folder for overrides」→ 新建一个空文件夹(如 atoms-overrides)并授予访问权限。
刷新页面后,Atoms 会在该文件夹下自动生成与接口请求路径一致的子目录结构。例如:/api/user/profile → 会对应生成 atoms-overrides/api/user/profile 文件夹。
【必须在该文件夹内新建 response.json 文件,否则覆盖不会生效】
编写修改逻辑:静态替换与动态注入混合
在 atoms-overrides/api/user/profile/response.json 中写入完整的响应内容。需要注意的是:Atoms 默认会使用该文件内容整体替换原始响应体,因此不支持直接执行脚本逻辑。
当需要对返回字段进行动态处理时,例如将 phone 字段脱敏为 138****1234 这类格式,可借助外部工具预先生成所需 JSON。这里推荐使用 VS Code,并安装「JSON Tools」插件。常见操作步骤为:选中原始响应内容,然后右键选择「Transform: Replace」,接着输入正则表达式 "phone":s*"(d{3})d{4}(d{4})",最后替换为 保存修改后,Atoms 会自动监听文件变化。再次发起该接口请求时,浏览器将直接返回 response.json 中的内容,并且在 DevTools 的 Network 面板中,该请求状态码会显示为 (from override)。 在 Overrides 面板中,点击左上角的「Enable Overrides」开关并将其关闭(变为灰色)。关闭后,所有已被拦截的请求会立即恢复为直连后端接口,不再读取本地覆盖文件。 如果需要彻底清理本次接口覆盖记录,可在 Overrides 面板中右键任意文件 → 选择「Delete override」,或者直接删除 atoms-overrides 文件夹。关闭覆盖并恢复原始接口
