Click 默认将参数名转为小写并用下划线连接，导致大写命名（如 PATH）在函数签名中被映射为 path，引发 TypeError；启用 case_sensitive=True 可强制保留原始大小写。
click 默认将参数名转为小写并用下划线连接，导致大写命名（如 `path`）在函数签名中被映射为 `path`，引发 `typeerror`；启用 `case_sensitive=true` 可强制保留原始大小写。
Click 是一个广受欢迎的 Python 命令行接口库，以其简洁性和可扩展性著称。然而，其默认行为会对参数名称进行标准化处理：所有参数名（包括 @click.argument 和 @click.option）会被自动转换为小写，并将连字符 - 替换为下划线 _，以适配 Python 的标识符规范。这一机制虽提升了兼容性，却会与显式使用大写命名（如 PATH）的函数参数产生冲突——例如，当定义 def f1(PATH): 时，Click 默认尝试以 path= 关键字调用该函数，从而触发 TypeError: f1() got an unexpected keyword argument 'path'。
解决方法是在 @click.command() 装饰器中显式设置 case_sensitive=True 参数。该选项自 Click v8.0 起正式支持，启用后 Click 将严格按装饰器中声明的参数名（如 "PATH"）进行关键字传递，不再做大小写或符号归一化。
以下是修复后的完整示例：
from rich.traceback import install
install(show_locals=True)
import click
@click.command(case_sensitive=True) # ✅ 关键：启用大小写敏感模式
@click.argument("PATH", envvar="PATH", nargs=-1, type=click.Path())
def f1(PATH):
print("Received paths:", PATH)
if __name__ == "__main__":
f1()
✅ 使用说明：
- 运行 python script.py /tmp /var/log 将正确输出 ('/tmp', '/var/log')；
- 若同时设置 envvar="PATH"，环境变量值也会被注入（注意：避免与系统 PATH 冲突，生产中建议使用更明确的变量名如 MY_PATHS）；
- case_sensitive=True 仅影响参数名到函数参数的映射，不影响命令、选项的解析逻辑（如 --help 仍为小写）。
⚠️ 注意事项：
- 此选项需全局启用（即每个 @click.command() 单独设置），不支持模块级或应用级默认配置；
- 混用大小写敏感与非敏感命令在同一程序中可能导致维护混乱，建议团队统一约定；
- 若依赖旧版 Click（
通过合理启用 case_sensitive=True，你既能保持代码语义清晰（如匹配环境变量名 PATH），又能规避隐式转换带来的运行时错误，是构建健壮 CLI 工具的重要实践之一。
