如何用Python获取API函数的可选参数？以sns.set_style为例

一、针对seaborn.set_style()的具体查询方式 #

seaborn的set_style()函数用于设置绘图风格，其style参数的可选值可以通过以下方式直接获取：

1. 使用help()函数 #

在Python交互环境中执行：

import seaborn as sns
help(sns.set_style)

返回的文档中会明确列出style参数的可选值："white", "dark", "whitegrid", "darkgrid", "ticks"，同时会说明每个风格的特点。

2. 查看函数的__doc__属性 #

直接打印函数的文档字符串：

import seaborn as sns
print(sns.set_style.__doc__)

输出内容和help()一致，包含完整的参数说明与可选值列表。

二、通用的API函数可选参数查询方法 #

以下方法适用于绝大多数Python函数/API：

1. 基础方法：help()函数 #

这是最直接的方式，对任意函数调用help(func)，会输出该函数的完整文档，包括参数定义、可选值、返回值说明等。示例：

help(print)  # 查看内置print函数的参数信息

2. 访问__doc__属性 #

函数的文档字符串存储在__doc__属性中，直接打印即可获取：

import os
print(os.mkdir.__doc__)

3. 使用inspect模块提取结构化信息 #

inspect模块可以更灵活地提取函数的参数、文档等信息，适合程序化处理：

import inspect
import seaborn as sns

# 获取函数签名（参数列表）
sig = inspect.signature(sns.set_style)
print("函数参数:", list(sig.parameters.keys()))

# 获取完整文档
doc = inspect.getdoc(sns.set_style)
print("\n函数文档:\n", doc)

4. 针对枚举类参数的查询 #

如果函数的参数是枚举类型（比如某些库会用枚举限定可选值），可以直接查看枚举类的成员：

from enum import Enum

class StyleEnum(Enum):
    WHITE = "white"
    DARK = "dark"

# 查看所有可选枚举值
print([member.value for member in StyleEnum])

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