目前主流 python 静态检查工具（如 ruff、flake8、pylint）均不提供原生规则来全局禁止 *args 和 **kwargs，因其存在大量合理使用场景；但可通过类型强制（如 mypy -no-untyped-defs）结合团队规范与教育，有效约束滥用。
目前主流 python 静态检查工具（如 ruff、flake8、pylint）均不提供原生规则来全局禁止 *args 和 **kwargs，因其存在大量合理使用场景；但可通过类型强制（如 mypy -no-untyped-defs）结合团队规范与教育，有效约束滥用。
在 Python 工程实践中，*args 和 **kwargs 虽为语言级特性，却常被误用为“免维护签名”的捷径——例如将所有函数统一声明为 def handler(**kwargs): ...。这类写法短期内规避了参数调整成本，长期却严重损害可读性、可测试性与静态类型检查能力。遗憾的是，尚无成熟 linting 工具支持开箱即用的“禁止可变参数”规则。
Ruff 作为当前最活跃的 Python linter，已集成 Flake8、pyflakes、isort 等主流规则集，但其官方规则库（截至 v0.7+）仍明确不包含 BAN_ARGS_KWARGS 或类似禁令。根本原因在于：*args 和 **kwargs 在装饰器、适配器、泛型转发等场景中不可替代。强行全局禁止会破坏合法抽象，违背 linting “辅助而非阻碍开发”的设计哲学。
✅ 更务实的工程化对策是 “以类型驱动规范”：
-
启用 mypy 的强类型守门机制
在 pyproject.toml 中配置：[tool.mypy] disallow_untyped_defs = true disallow_incomplete_defs = true warn_return_any = true
此时，若函数使用 **kwargs 却未标注其类型（如 **kwargs: dict[str, Any]），mypy 将直接报错：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac下载让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
def bad_handler(**kwargs): # ❌ Error: Untyped function pass def good_handler(**kwargs: dict[str, str]): # ✅ Explicitly typed pass -
配合类型提示提升可维护性
对常见 **kwargs 模式，优先使用 TypedDict 或 @dataclass 明确契约：from typing import TypedDict class HandlerOptions(TypedDict): timeout: int retry: bool log_level: str def handle_request(**options: Unpack[HandlerOptions]) -> None: # Python 3.12+ ... -
辅以团队治理手段
- 在代码审查（PR）清单中加入“检查 *args/**kwargs 是否有充分理由”条目；
- 编写内部文档《何时及如何安全使用可变参数》，列举反模式（如“为避免修改函数签名而滥用 **kwargs”）与正例（如实现 functools.wraps 兼容装饰器）；
- 利用 Ruff 的 per-file-ignores 临时豁免历史代码，聚焦新模块的合规性。
⚠️ 注意：切勿依赖正则扫描或自定义 AST 插件进行粗暴拦截——这会误伤 def __init__(self, *args, **kwargs) 等标准模式，且难以维护。真正的质量防线在于 类型系统 + 显式契约 + 工程文化 的三层协同。
总结而言，禁止可变参数并非技术不可行，而是权衡后的主动取舍。与其追求“一刀切”的静态限制，不如通过 mypy 强制类型、文档明确边界、评审落实共识，让 *args 和 **kwargs 回归其本意：解决真正需要动态性的场景，而非掩盖设计缺失。
