一、下载 Postman
1. 官方下载渠道（务必认准）
-
官网地址：Download Postman | Get Started for Free
-
选择版本：
-
页面会自动检测你的操作系统，显示对应版本下载按钮（如 "Download for Windows"）。
-
也可手动选择：
Windows|macOS|Linux (x64 / ARM)。
-
2. 各系统安装包说明
| 操作系统 | 安装包格式 | 备注 |
|---|---|---|
| Windows |
.exe (推荐) 或 .zip 便携版 |
选 exe 自动更新更方便 |
| macOS |
.dmg 或 .zip
|
.dmg 是标准安装包 |
| Linux |
.tar.gz 或 Snap / APT 仓库安装 |
推荐下载 .tar.gz 解压即用 |
⚠️ 安全提示：务必从官网下载！第三方渠道可能捆绑恶意软件或版本滞后。
二、安装 Postman
▍ Windows 系统安装
-
运行安装程序：双击下载的
.exe文件 (如Postman-win64-Setup.exe)。 -
权限确认：若出现 用户账户控制 (UAC) 弹窗，点击
是。 -
自动安装：等待进度条完成，无需手动配置路径（默认安装到
%LocalAppData%\Postman）。 -
完成安装：安装完成后自动启动 Postman，桌面和开始菜单会生成快捷方式。
▍ macOS 系统安装
-
打开镜像文件：双击下载的
.dmg文件。 -
拖拽安装：将 Postman.app 图标拖拽到 Applications 文件夹。
-
首次运行：
-
打开 Launchpad 或 应用程序文件夹，双击
Postman.app。 -
若提示 "无法验证开发者"，前往：
系统设置 → 隐私与安全性 → 安全性→ 点击 "仍要打开"。
-
-
创建快捷方式：可将 Postman 图标拖到 Dock 栏方便启动。
▍ Linux 系统安装（以 .tar.gz 为例）
# 1. 解压安装包 (将X.X.X替换为实际版本号)
tar -xzvf Postman-linux-x64-X.X.X.tar.gz -C ~/Applications
# 2. 创建启动脚本（可选但推荐）
cat > ~/.local/bin/postman <<'EOF'
#!/bin/bash
~/Applications/Postman/app/Postman
EOF
chmod +x ~/.local/bin/postman
# 3. 创建桌面快捷方式
cat > ~/.local/share/applications/postman.desktop <<EOF
[Desktop Entry]
Name=Postman
Exec=/home/YOUR_USERNAME/Applications/Postman/app/Postman
Icon=/home/YOUR_USERNAME/Applications/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;
EOF
说明：
将
YOUR_USERNAME替换为你的用户名。通过终端输入
postman或点击桌面图标启动。
三、首次运行与基础配置
1. 启动界面与登录/注册
| 步骤 | 操作说明 |
|---|---|
| 启动 Postman | 双击桌面图标或从应用菜单打开 |
| 账户选择 | 弹出登录窗口： • Sign In：已有账户登录 • Create A***ount：注册新账户 |
| 推荐注册/登录 | ✅ 强烈建议登录账户：解锁云端同步、协作、历史记录保存等核心功能 |
| 跳过登录 (不推荐) | 点击左下角 Skip and go to the app → 功能受限（无法同步、共享） |
2. 主界面概览与设置
| 区域 | 功能说明 |
|---|---|
| 侧边栏 (左) | • History：请求历史 • Collections：API 集合 • APIs：API 设计 • Environments：环境变量 • Mock Servers：模拟服务器 • Monitors：监控器 |
| 工作区 (中) | 请求构建区、响应展示区、测试脚本编辑区 |
| 顶部工具栏 | 新建请求、导入/导出、运行集合、切换环境、搜索等 |
| 状态栏 (右下) | 同步状态、通知中心、帮助文档入口 |
3. 关键初始配置
(1) 设置代理（如需科学上网）
-
路径：
Settings (⚙️) → Proxy -
配置选项：
-
Global Proxy Configuration：选择
Use system proxy或手动设置地址/端口 -
SSL 证书验证：关闭
SSL certificate verification（仅在内网测试时禁用）
-
(2) 切换主题与字体
-
路径：
Settings → Theme -
推荐设置：
-
Theme：
Dark(护眼) 或Light -
Font Size：根据屏幕分辨率调整（默认
14px）
-
(3) 开启自动更新（确保功能最新）
-
路径：
Settings → Update -
勾选：
Enable automatic updates
四、核心功能配置详解
1. 环境变量 (Environments) - API 多环境切换核心
▍ 创建环境
-
点击左侧 Environments →
+新建 -
输入环境名称 (如
Dev,Test,Prod) -
在表格中添加变量：
Variable Initial Value Current Value 示例 base_urlhttp://dev.api.***(自动同步) 基础 API 地址 api_keydev_key_123(自动同步) 认证密钥
▍ 使用变量
-
在 URL、Headers、Body 中用双花包裹变量名：
{{base_url}}/users -
切换环境：顶部右上角下拉菜单选择环境（如
Dev→Prod）
2. 全局变量 (Globals) - 跨环境共享数据
-
创建路径：点击 👁️ 图标 (右上角) →
Globals→Add variable -
典型用途：存放认证 Token、通用配置（如超时时间）
3. 集合 (Collections) - 组织 API 请求
▍ 创建集合
-
点击 Collections →
+ -
输入名称（如
User Management API） -
(可选) 添加描述、授权规则、预请求脚本
▍ 添加请求到集合
-
新建请求 (
+或Ctrl+N) -
设置请求方法、URL、参数等
-
点击 Save → 选择目标集合 → 命名请求（如
Get User List）
五、高级配置与优化
1. 证书配置 (HTTPS 测试)
-
路径：
Settings → Certificates -
场景：导入客户端证书 (
.pfx或.pem) 以访问需双向认证的 API
2. 键盘快捷键自定义
-
路径：
Settings → Shortcuts -
常用快捷键：
-
Ctrl + /：聚焦地址栏 -
Ctrl + Enter：发送请求 -
Ctrl + Alt + C：生成代码片段
-
3. 数据同步设置
-
路径：
Settings → Data -
推荐配置：
-
开启
Automatically sync my data(实时同步) -
勾选
Sync cookies(跨设备同步 Cookie)
-
六、安装验证与测试
-
发送首个 API 请求：
-
新建请求 → 输入
https://postman-echo.***/get?test=123 -
点击 Send → 查看右侧响应体（应返回输入的参数）
-
-
环境变量测试：
-
创建环境
TestEnv→ 添加变量url = https://postman-echo.*** -
在请求 URL 输入
{{url}}/get→ 切换环境 → 发送成功即配置正确
-
-
检查更新状态：
-
点击右下角云朵图标 → 显示
In sync表示同步正常
-
附：故障排查清单
| 问题现象 | 解决方案 |
|---|---|
| 安装失败 (权限不足) | Windows/macOS：以管理员身份运行安装程序；Linux：使用 sudo 解压到 /opt
|
| 启动报错 (依赖缺失) | 安装 Visual C++ Redistributable (Windows) 或更新 GLIBC (Linux) |
| 无法登录/同步 | 检查网络代理 → 关闭 VPN → 重置密码 → 官方状态页 status.postman.*** |
| 环境变量不生效 | 确认环境已选中 → 变量名拼写一致 → 重启 Postman |
