当使用threading.Thread传递单个参数时，若未正确构造元组，Python会将字符串自动解包为多个字符参数，导致“预期1个参数但收到N个”的TypeError。根本原因在于(arg)不是元组，而(arg,)才是合法单元素元组。
当使用threading.thread传递单个参数时，若未正确构造元组，python会将字符串自动解包为多个字符参数，导致“预期1个参数但收到n个”的typeerror。根本原因在于`(arg)`不是元组，而`(arg,)`才是合法单元素元组。
在Python中，threading.Thread 的 args 参数必须是一个元组（tuple），用于按顺序向目标函数传递位置参数。元组的语法有明确约定：即使只有一个元素，也必须添加末尾逗号，否则圆括号仅表示分组或优先级，而非元组字面量。
例如：
- (support_device) → 这不是元组，只是对变量 support_device（如 "emulator-5564"）加了括号，等价于 support_device 本身；
- 当该字符串被传入 args 时，threading.Thread 会将其视为可迭代对象并逐个解包——即把 "emulator-5564" 拆成 ('e', 'm', 'u', 'l', 'a', 't', 'o', 'r', '-', '5', '5', '6', '4') 共13个字符，作为13个独立参数传给 go_to_main_coords()，从而触发 TypeError: go_to_main_coords() takes 1 positional argument but 13 were given。
✅ 正确写法（单元素元组）：
support_thread = threading.Thread(
target=go_to_main_coords,
args=(support_device,) # 注意末尾的逗号！
)
❌ 错误写法（仅带括号，非元组）：
support_thread = threading.Thread(
target=go_to_main_coords,
args=(support_device) # ❌ 缺少逗号 → 不是元组 → 字符串被解包
)
? 验证小技巧：可在交互式环境中快速检查：
>>> type((support_device)) <class> # 没有逗号 → 就是原字符串类型 >>> type((support_device,)) <class> # 有逗号 → 真正的单元素元组 >>> len((support_device,)) 1 # 元组长度为1 >>> len((support_device)) 13 # 字符串长度为13（取决于实际值）</class></class>
⚠️ 注意事项：
- 多参数时逗号可省略（如 (a, b, c) 是合法元组），但单参数时逗号不可省略；
- 若目标函数无需参数，应显式使用空元组 args=()，而非 args=None 或 args=()（后者错误写法）；
- 使用 kwargs 可规避此问题（如 kwargs={'device': support_device}），但需确保函数签名匹配；
- 在重构函数参数时，务必同步更新 Thread 构造中的 args 或 kwargs，避免隐式解包。
总结：Python元组的语法细节直接影响多线程参数传递的正确性。牢记「单元素元组必须带尾逗号」这一原则，能有效避免此类隐蔽且易混淆的运行时错误。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
