刚开始我挺抗拒Postman的。就觉得，curl敲两行不就能发请求吗？干嘛非装个App。
后来真香了。
先说说我踩过的坑
下载安装
一开始我直接去[Postman官网](https://www.postman.com/downloads/)下的桌面版。网页版我
也试过，体验差一大截。环境变量切换的时候特别慢，脚本调试也不方便。所以还是桌面版靠谱。
安装完首次启动会让你登录。我当时图省事儿，想着跳过算了。结果后来换电脑，所有数据都没了。那个坑踩得我挺疼的。所以建议你注册一下，关联集合、环境、历史记录，一键同步。真的省心。
对了，自动更新这个事，我也有话说。2023年初某个版本更新后，我所有请求的Headers里莫名其妙多了个X-Forwarded-For字段。你猜咋了？测试环境的鉴权逻辑全炸了。排查了3小时才发现是更新搞的鬼。后来我直接在设置里关了自动更新，等新版本稳定一周后再手动更。路径：Settings → General → Update → Disable auto-update。
核心功能，我上手的过程
发第一个请求
先别整复杂的。我从GitHub的公开API开始。新建请求：点击左上角“New”→“HTTP Request”，URL填https://api.github.com/users/octocat，方法选GET，点“Send”。响应区会显示JSON格式的用户数据，状态码200就对了。
这里有个小技巧我一开始没发现：响应区右上角的“Pretty”按钮，可以自动格式化JSON。比手动缩进快10倍。
环境变量管理——这个功能真的好用
开发环境、测试环境、生产环境的接口地址通常不一样。如果每次切换都要手动改URL，效率低到想哭。解决方案：用环境变量。
具体操作：
base_url = http://dev-api.example.combase_url = https://api.example.com{{base_url}}/users代替完整URL我发现的另一个坑：一开始我只把URL放变量里，后来发现API Key、Token这些敏感信息也放进去才安全。这样你分享集合给同事时，不会暴露密钥。Postman会自动将环境变量与集合分开存储。
集合管理
当你需要测试20多个接口时，零散管理会让人崩溃。集合就是用来组织请求的文件夹。点击“New”→“Collection”，命名“用户管理API”，把刚才的GitHub请求拖入集合。
高级用法：集合支持嵌套文件夹。比如“用户管理”下分“查询”、“新增”、“删除”三个子文件夹，每个文件夹放对应接口。这样团队协作时，每个人都能快速找到需要的接口。
自动化测试脚本
Postman最强大的功能之一是Pre-request Script和Tests脚本。它们让你在请求前后执行JavaScript代码。
测试脚本基础
在“Tests”标签页里写脚本，请求完成后会自动执行。
“javascript
// 验证状态码
pm.test("Status code is 200", function () {
pm.response.to.have.status(200);
});
// 验证响应时间
pm.test("Response time is less than 500ms", function () {
pm.expect(pm.response.responseTime).to.be.below(500);
});
// 提取并保存Token
pm.test("Extract token from response", function () {
var jsonData = pm.response.json();
pm.environment.set("access_token", jsonData.token);
});
`
踩过的坑：脚本里不能直接使用console.log调试，因为输出不会显示在响应区。正确做法是用console.log配合“View → Show Postman Console”查看日志，或者用pm.test的第二个参数输出信息。
前置脚本
在请求发送前执行，适合生成签名、计算时间戳等场景。
`javascript
// 生成当前毫秒级时间戳
const timestamp = Date.now();
pm.variables.set("timestamp", timestamp);
// 计算签名（假设签名规则：md5(timestamp + apiKey)）
const apiKey = pm.environment.get("api_key");
const sign = CryptoJS.MD5(timestamp + apiKey).toString();
pm.variables.set("sign", sign);
`
然后在请求参数里用{{timestamp}}和{{sign}}引用即可。
批量运行测试
集合里的所有请求可以一键批量运行：右键集合 → “Run Collection”，选择运行次数、延迟间隔，点击“Run”。我的经验：批量运行时，把测试环境变量切换到“测试环境”，并设置每次请求间隔500ms以上，避免被服务器限流。如果测试的是写操作（创建/删除），记得先整理好测试数据的清理逻辑。
高级功能与效率技巧
动态数据生成（Mock Server）
开发前端时，后端接口还没写好怎么办？用Postman的Mock Server生成模拟数据。在集合上右键 → “Mock Servers” → “Add Mock Server”，选择集合，设置环境，生成Mock URL。前端可以直接用Mock URL开发，等后端接口写好后再切换。
注意：Mock Server返回的数据基于集合中的示例响应，所以建议每个请求至少保存一个示例响应。
文档自动生成
Postman会自动根据你的请求生成API文档。在集合上点击“View in Web”→“Published”→“Publish”，就能得到一个公开的API文档页面。
实用技巧：在请求的描述字段里写清楚参数说明、返回值含义、使用场景。比如：
`
描述：获取用户基本信息
参数：
- user_id: 用户ID，必填，格式为UUID
- fields: 返回字段列表，可选，用逗号分隔
返回值：
- id: 用户ID
- name: 用户昵称
- email: 用户邮箱（仅管理员可见）
这样生成的文档直接可用于团队内部或对第三方开发者公开。
团队协作
Postman的Workspace功能支持多人实时编辑集合。创建Workspace：左侧“Workspaces”→“Create Workspace”，邀请成员：输入邮箱或分享链接，设置权限：编辑/只读/管理员。
最佳实践：每个项目创建一个Workspace，所有接口集合放在里面。成员修改后会实时同步，并显示修改记录。如果发现接口被改坏了，可以查看历史版本并回滚。
代码生成
Postman支持将请求一键转换成多种语言的代码。点击请求右侧的“Code”按钮，选择语言：cURL、Python Requests、JavaScript (fetch/Axios)、Java OkHttp、Go。
实际场景：我在写文档时经常用这个功能。写完一个接口，直接生成Python示例代码贴在文档里，比手写准确率提高80%。
日常使用建议与避坑指南
必须养成的习惯
（Mac）或Ctrl+S（Windows），避免关闭标签页后丢失踩过的坑汇总
| 坑点 | 后果 | 解决方法 |
|------|------|----------|
| 环境变量未正确引用 | 请求发送到错误的环境 | 使用{{variable}}格式，检查变量名拼写 |Settings → General → Request timeout
| 测试脚本未保存 | 运行集合时脚本不执行 | 每次修改脚本后点保存，或使用自动保存功能 |
| 请求头遗漏 | 接口返回403/401 | 在集合级别设置公共Headers（右键集合 → Edit → Headers） |
| 响应超时设置过短 | 接口正常但显示超时 | 设置里增加超时时间： |
性能优化建议
如果Postman越来越卡，可以试试：
从工具到工作流
Postman不只是个“发请求的工具”，它可以成为你API开发的核心枢纽。我现在的日常流程是：设计阶段在Postman中定义接口格式（请求参数、响应结构），开发阶段用Mock Server模拟接口，前后端并行开发，测试阶段批量运行脚本验证，最后自动生成文档分享给团队。
说到底，踩过的坑都变成了习惯。关键是别让它成为你电脑里的一个废图标。