命名关键字参数必须通过关键字传递，使用星号*分隔位置参数与关键字参数，确保调用时显式传参，提升函数接口清晰度和安全性。
在python中，命名关键字参数（keyword-only arguments）是指必须通过关键字传递的参数，不能通过位置传递。这种参数定义方式增强了函数调用的清晰性和安全性。正确使用命名关键字参数需要注意以下几点。
确保参数只能通过关键字传入
使用星号 * 可以将后面的参数设为命名关键字参数。这意味着调用函数时必须显式写出参数名。
例如：
def create_user(name, *, age, email): print(f"Name: {name}, Age: {age}, Email: {email}") <h1>正确调用</h1><p>create_user("Alice", age=25, email="alice@example.com")</p><h1>错误调用：age 和 email 是命名关键字参数，不能作为位置参数</h1><h1>create_user("Alice", 25, "alice@example.com") # 报错</h1><p>
立即学习“Python免费学习笔记（深入）”；
利用默认值提高灵活性
命名关键字参数可以设置默认值，这样在调用时可以省略该参数。
例如：
def connect(host, *, port=80, timeout=30): print(f"Connecting to {host}:{port}, timeout={timeout}") <h1>调用时可省略有默认值的参数</h1><p>connect("example.com") connect("example.com", port=443)
这样既保证了接口清晰，又提升了调用便利性。
结合 *args 使用时注意顺序
当函数同时使用 *args 和命名关键字参数时，* 后面的参数才属于命名关键字参数。
例如：
def log(message, *args, level="INFO", timestamp=None): time_str = timestamp or "now" print(f"[{time_str}] {level}: {message}") if args: print("Details:", args) <p>log("Error occurred", "file not found", "retry failed", level="ERROR")
这里 level 和 timestamp 必须通过关键字传入，即使它们出现在 *args 之后。
使用空星号隔离命名关键字参数
如果不需要收集位置参数，但仍然想定义命名关键字参数，可以使用单独的 *。
例如：
def configure(*, debug=False, log_file=None): if debug: print("Debug mode on") if log_file: print(f"Logging to {log_file}")
这样函数只接受关键字参数，调用时必须写明参数名，避免误传位置参数。
基本上就这些。合理使用命名关键字参数能让函数接口更明确，减少调用错误，特别是在参数较多或含义相近时特别有用。关键是理解 * 的作用位置和参数顺序。不复杂但容易忽略。