如何为Python函数和类设置互斥参数？

刚好遇到过类似的需求，给你梳理两种场景下的解决方案——函数和类的互斥参数处理，完全适配你说的外部API要求：

最直接的方式是在函数内部做参数校验，用默认值None标记参数是否被传入，然后判断是否符合「必须且只能传一个」的规则：

def process_data(file_path=None, data_dict=None):
    # 校验互斥条件：不能同时传两个，也不能都不传
    if (file_path is not None and data_dict is not None) or (file_path is None and data_dict is None):
        raise ValueError("必须传入file_path或data_dict中的一个，且不能同时传入")
    
    # 根据传入的参数执行逻辑
    if file_path is not None:
        with open(file_path, 'r') as f:
            return f.read()
    else:
        return data_dict

调用时如果同时传两个或者都不传，就会抛出明确的错误提示，完全符合需求。

针对类的场景，我们可以在__init__方法里做初始化校验；如果需要后续修改属性时也保持互斥，还可以配合@property装饰器做限制：

基础版（仅初始化校验） #

class APIClient:
    def __init__(self, api_key=None, access_token=None):
        # 互斥规则校验
        if api_key is not None and access_token is not None:
            raise ValueError("api_key和access_token不能同时传入")
        if api_key is None and access_token is None:
            raise ValueError("必须传入api_key或access_token中的一个")
        
        self.api_key = api_key
        self.access_token = access_token

进阶版（支持后续修改属性时的互斥校验） #

如果你的类需要允许后续修改这两个属性，用@property可以确保任何时候都保持互斥：

class APIClient:
    def __init__(self, api_key=None, access_token=None):
        self._api_key = None
        self._access_token = None
        
        # 初始化时先设置参数（利用setter的校验逻辑）
        if api_key is not None:
            self.api_key = api_key
        elif access_token is not None:
            self.access_token = access_token
        else:
            raise ValueError("必须传入api_key或access_token中的一个")
    
    @property
    def api_key(self):
        return self._api_key
    
    @api_key.setter
    def api_key(self, value):
        if value is not None and self._access_token is not None:
            raise ValueError("设置api_key时，access_token必须为None")
        self._api_key = value
    
    @property
    def access_token(self):
        return self._access_token
    
    @access_token.setter
    def access_token(self, value):
        if value is not None and self._api_key is not None:
            raise ValueError("设置access_token时，api_key必须为None")
        self._access_token = value

更优雅的方式：用dataclasses做校验 #

如果你用Python 3.7+，可以结合dataclasses的__post_init__方法来做校验，代码更简洁：

from dataclasses import dataclass
from typing import Optional

@dataclass
class APIClient:
    api_key: Optional[str] = None
    access_token: Optional[str] = None
    
    def __post_init__(self):
        if (self.api_key is not None and self.access_token is not None) or (self.api_key is None and self.access_token is None):
            raise ValueError("必须且只能传入api_key或access_token中的一个")

你提到的argparse确实是命令行场景下处理互斥参数的标准工具，比如：

import argparse

parser = argparse.ArgumentParser(description="处理互斥参数的命令行工具")
# 创建互斥参数组，设置required=True确保必须传一个
mutex_group = parser.add_mutually_exclusive_group(required=True)
mutex_group.add_argument("--api-key", type=str, help="API密钥")
mutex_group.add_argument("--access-token", type=str, help="访问令牌")

args = parser.parse_args()
# 后续根据args中的参数初始化类或调用函数
client = APIClient(api_key=args.api_key, access_token=args.access_token)

但这只适用于命令行输入的场景，代码内部调用函数或实例化类时，还是用前面提到的参数校验方法更直接。

内容的提问来源于stack exchange，提问作者Stevoisiak