如何查找Rust宏的参数与语法？以salvo_oapi为例

针对你使用salvo_oapi crate时找不到支持的宏、宏名称及输入要求的问题，以下是几个实用的解决途径：

• 直接查看源码：
  宏的定义通常放在crate的lib.rs、macros.rs或单独的宏模块中。比如你用到的#[endpoint]宏实际由salvo框架提供，salvo_oapi对其做了OpenAPI相关扩展。可以去salvo的源码仓库搜索宏定义，查看它支持的属性参数（如tags、operationId）的具体要求。

• 生成本地完整文档：
  执行cargo doc --open命令，生成并打开当前项目的本地文档。本地文档包含所有依赖crate的详细说明，包括宏的注释、参数列表、使用示例。搜索endpoint或其他相关宏，就能看到完整的用法说明，比在线文档更全面。

• 查看官方示例：
  前往salvo_oapi或salvo仓库的examples目录，找到使用宏的示例代码。这些示例会展示宏的各种用法，包括支持的属性参数、输入格式，能直观了解宏的使用规则。

• 确认feature开启状态：
  有些宏需要开启特定feature才能使用。检查你的Cargo.toml中salvo_oapi的依赖配置，确保启用了需要的feature（如openapi相关feature），避免因feature未开启导致宏不可用或文档缺失。

以你给出的代码为例，#[endpoint(tags("Auth"), operationId = "fetch_user")]中的tags和operationId是salvo_oapi为endpoint宏添加的OpenAPI元数据属性，用于生成对应的API文档标签和操作ID，这些参数的具体要求可在本地文档或源码注释中找到详细说明。

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