什么是 Posting？
Posting 是一款专为开发者设计的现代化终端 API 测试工具，它结合了 Postman 的强大功能和终端的高效性。无论是快速测试 REST API，还是管理复杂的请求集合，Posting 都能让你在终端中享受流畅的开发体验。
快速安装
Posting 支持 macOS、Linux 和 Windows 系统，推荐使用 uv 进行安装，这是由 Rust 编写的高性能 Python 包管理工具，安装速度极快。
使用 uv 安装（推荐）
# 安装 uv（macOS/Linux）
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装 Posting（自动管理 Python 3.12）
uv tool install --python 3.12 posting
# 启动 Posting
posting
uv 的优势在于毫秒级的安装速度，并且会自动管理 Python 环境，无需手动配置。你还可以轻松安装额外的 Python 包，用于前置请求或后置响应脚本。
使用 pipx 安装
pipx install posting
注意：不要使用 pip 直接安装，也不要通过 Homebrew 安装（编译依赖需要超过 10 分钟）。
个性化界面配置
Posting 提供两种界面模式：
- standard（默认）：包含额外的内边距和边框，视觉效果更舒适
- compact：紧凑布局，移除边框和内边距，适合小屏幕
按 Ctrl+P 打开命令面板，输入 spacing 即可切换模式。要永久配置，编辑配置文件（使用 posting locate config 查找位置）：
spacing: compact
theme: dracula # 可选主题
快速上手：创建你的第一个请求
1. 创建请求集合
集合（Collection）是存储请求的目录。默认情况下，请求会保存到全局默认集合，但建议为每个项目创建独立集合以便版本控制：
mkdir my-api-tests
posting --collection my-api-tests
请求会以 .posting.yaml 格式的 YAML 文件保存，便于 Git 管理。
2. 设置请求方法和 URL
启动 Posting 后，按以下快捷键操作：
Ctrl+T：打开请求方法下拉菜单P：快速选择 POST 方法（下划线字母为快捷键）Ctrl+L：快速聚焦到 URL 输入栏
输入测试 API 地址：https://jsonplaceholder.typicode.com/users
URL 栏会高亮显示 URL 各部分，帮助识别拼写错误，并自动补全之前使用过的域名。
3. 添加 JSON 请求体
Ctrl+O：进入"跳转模式"W：快速跳转到 Body 标签页J或↓：移动到下拉菜单Enter：选择Raw (json, text, etc.)- 输入 JSON 数据：
{
"name": "Alice Ak",
"username": "alice",
"email": "alice.ak@example.com"
}
右下角会自动识别 JSON 格式，提供语法高亮并自动添加 Content-Type: application/json 请求头。
4. 发送请求
按 Ctrl+J 发送请求（全局快捷键）。如果终端支持 Kitty 键盘协议，也可以使用 Alt+Enter。
5. 查看和导航响应
请求发送后，响应会显示在主界面：
Ctrl+O+A：跳转到响应 Body 标签页J/K或↓/↑：上下滚动Shift+ 方向键：选择文本Y或C：复制选中内容（未选中则复制全部）
Vim 用户福利：响应文本区域支持 Vim 键位：
V：进入可视模式，使用hjkl选择文本%：跳转到匹配的括号W/B：跳到下一个/上一个单词
你还可以配置外部编辑器查看响应：
export POSTING_PAGER_JSON="fx" # 使用 fx 查看 JSON
6. 保存请求
按 Ctrl+S 保存请求到磁盘，填写表单后按 Enter 或 Ctrl+N 确认。
提示：在"Path in collection"字段中使用 / 可以创建文件夹结构，例如 users/create-user 会自动创建 users 目录。
核心特性亮点
- 键盘驱动：所有操作都可通过快捷键完成，大幅提升效率
- Jump Mode：
Ctrl+O进入跳转模式，一键跳转到任意组件 - 命令面板：
Ctrl+P访问所有命令和主题切换 - 快捷键帮助：按
F1查看当前组件的所有快捷键 - 自定义键位：通过 Keymaps 重新映射快捷键
总结
Posting 将 API 测试带回终端，提供了现代化的用户体验。无论是快速调试接口，还是维护大型请求集合，它都能胜任。安装只需几秒钟，键盘驱动的工作流让你双手不离键盘，开发效率倍增。立即尝试，体验终端 API 测试的新境界！
