add()只能添加单个可哈希元素，如int、str、tuple；update()才用于批量添加，会解包可迭代对象的每个元素。误用add()添加列表或集合会报错或导致嵌套，而update()传入非迭代对象也会报错。
add()只能加单个元素，加多了会报错
add() 是集合的原生方法，只接受一个参数。传入列表、元组、集合等可迭代对象时，Python 不会自动拆开，而是把整个对象当做一个整体加进去——这通常不是你想要的，而且如果对象是不可哈希的（比如 list），直接抛 TypeError: unhashable type。
常见错误现象：my_set.add([1, 2]) 立刻报错；my_set.add({1, 2}) 同样报错，因为 set 不可哈希；但 my_set.add((1, 2)) 可以，因为 tuple 可哈希。
- 适用场景：明确只加一个不可变值，比如
int、str、tuple - 别用它加
list、dict、set，哪怕你想“加进去”也不行 - 性能上无负担，O(1) 平均时间复杂度
update()才是批量添加的正解
update() 接收任意多个可迭代对象（list、tuple、set、str 甚至生成器），并把它们「逐个元素」解包后加入集合。它不关心你传的是什么类型，只关心里面的东西能不能哈希。
使用场景：从 API 拿回一个 list 要去重存进集合；合并多个结果集；把字符串每个字符当元素加（s.update('abc') → 加入 'a'、'b'、'c'）。
立即学习“Python免费学习笔记（深入）”；
- 参数差异：
s.update([1,2], (3,4), {5,6})合法，等价于一次性加1,2,3,4,5,6 - 注意：
s.update('hello')会加五个字符，不是整个字符串；如果想加整个字符串，得用s.add('hello') - 兼容性没问题，所有 Python 版本都支持；但别传
None或非迭代对象，否则报TypeError: 'X' object is not iterable
误用 add() 当 update() 会导致嵌套集合
这是最隐蔽也最容易被忽略的问题：你以为加了一堆数，其实只加了一个 tuple 或 list 对象，后续查 in、遍历、取交集全都不按预期走。
比如：s = set(); s.add([1,2,3]) —— 报错；但换成 s.add((1,2,3)) 就成功了，此时 s 是 {(1, 2, 3)}，不是 {1,2,3}。之后写 2 in s 返回 False，而 (1,2,3) in s 才是 True。
- 调试技巧：打印
type(x)和len(s)，如果长度始终是 1 但你传了多个值，八成是误用了add() - IDE 一般不会警告，因为语法完全合法，只是语义错
- 这种错误在数据清洗、API 响应解析里高频出现，尤其处理 JSON 数组时容易下意识
add(data['items'])
update()不能传单个不可迭代对象，但add()可以
两者接口设计是对称的陷阱：add() 要单个哈希值，update() 要可迭代对象。所以 s.update(123) 必报错，因为 int 不可迭代；但 s.add(123) 完全 OK。
- 常见翻车点：把变量名当内容用，比如
data = get_items()，没检查data类型就直接s.update(data)，结果data有时是None、有时是int、有时才是list - 稳妥写法：加一层判断或包装，比如
s.update(data if hasattr(data, '__iter__') and not isinstance(data, (str, bytes)) else [data])，但更推荐提前约定接口返回类型 - 性能上，空列表
[]或空集合传给update()没开销，放心用
