该错误表示调用函数时缺少一个必需的位置参数，常见于类方法未通过实例调用导致self未传入、函数定义与调用参数数量不匹配、或导入覆盖引发误调用。
为什么调用函数时突然报 TypeError: missing 1 required positional argument
这错误说明你调用了某个函数，但少传了一个**必须的位置参数**——Python 没法给它默认值，也没法从上下文推出来，只能直接报错。不是语法错，也不是变量没定义，纯粹是“人数不够”。常见于类方法调用、漏写参数、或误把实例方法当静态函数用。
self 被当成普通参数漏掉了（最常见）
在类里定义的方法，默认第一个参数是 self，它代表当前实例。如果你直接通过类名调用（而不是实例），self 就不会自动传入，导致后面所有参数整体左移，第一个显式参数就被当成 self 的占位，实际值就缺了。
- 错误写法：
MyClass.do_something("hello")→self位置没东西，"hello"被强行塞进self，而真正需要的参数反而缺失 - 正确写法：
obj = MyClass(); obj.do_something("hello")，或把方法改成@staticmethod/@classmethod - 检查方法签名：如果定义是
def do_something(self, text):，那调用时必须有实例上下文，否则就得改装饰器
函数定义和调用参数数量对不上
哪怕不是类方法，只要定义时写了两个位置参数，调用时只给一个，就会触发这个错误。注意默认参数不缓解这个问题——只有带 = 的参数才算“可选”。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 错误示例：
def calc(a, b): return a + b，然后调用calc(5)→ 缺b - 修复方式：补全参数
calc(5, 3)，或改定义为def calc(a, b=0) - 注意：
*args和**kwargs不影响位置参数计数，它们只收尾部多余参数 - IDE 通常会标灰未使用的参数，但不会警告你少传——得靠自己核对定义和调用
从模块导入函数后调用出错，其实是重名覆盖了
你以为导入的是 A 模块的 process()，结果本地有个同名函数没写全参数，或者 import 写成了 from x import * 导致覆盖，运行时调用的其实是本地那个残缺版本。
- 查证方式：打印
process.__code__.co_argcount或用help(process)看真实签名 - 避免
import *，优先用from module import func或import module后加前缀 - 临时调试可在调用前加
print(process.__module__)确认来源
最容易被忽略的是：错误信息里写的“missing 1 required positional argument”并不告诉你缺的是哪个参数，也不会提示它原本叫什么名字——你得自己打开函数定义一行行数参数顺序，尤其当函数有多个同类型参数（比如全是 str）时，传错位置和传错数量表现一样。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
