更新资源时我们通常会用到PUT和PATCH这两个HTTP方法。虽然它们都能实现更新操作，但适用场景和底层逻辑却大不相同。本文将用通俗易懂的方式解析它们的区别，并给出实际开发中的最佳实践建议。

核心区别：全量更新 vs 部分更新

PUT：全量替换

PUT方法的本质是"完全替换"：

• 必须提交完整的资源数据

• 服务器会用提交的数据完全替换现有资源

• 是幂等操作（多次执行结果相同）

PUT /users/1
{
  "name": "Alice",
  "email": "alice@example.com",
  "age": 30
}

特点：

• 即使只想修改一个字段（如age），也必须提交所有字段

• 如果只提交部分数据，未提交的字段可能会被清空

• 适合场景：客户端拥有完整资源数据并需要完全替换

PATCH：部分更新

PATCH方法的本质是"局部修改"：

• 只需提交需要修改的字段

• 服务器只会更新指定字段

• 通常不是幂等操作

PATCH /users/1
{
  "age": 31
}

特点：

• 支持增量更新（如年龄+1）

• 节省带宽，只需传输变化的数据

• 适合场景：修改个别字段或进行增量调整

实际开发中的选择建议

1. 需要完全替换资源？ → 用PUT

2. 只需修改个别字段？ → 用PATCH

3. 需要确保操作幂等性？ → 用PUT或设计幂等的PATCH

常见问题解答

Q：能用PUT实现PATCH的功能吗？

技术上可以，但不推荐：

1. 需要先GET获取当前数据

2. 在客户端计算新值

3. 用PUT提交完整数据
   这样不仅效率低，还可能引发竞态条件。

Q：如何让PATCH操作具备幂等性？

避免使用增量操作，改用绝对赋值：

PATCH /users/1
{
  "age": 31  // 直接设置新值
}

总结

正确选择更新方法能让API更高效、更健壮。记住这个简单原则：

• 全量更新 → PUT

• 部分更新 → PATCH

希望这篇文章能帮助你更好地设计RESTful API。如果你有更多问题或见解，欢迎在评论区留言讨论！