java中throws声明的异常必须在javadoc中用@throws标签说明，格式为全限定名加空格及具体触发条件；仅对checked exception强制要求，runtime exception视契约重要性可选；描述需具体、可操作，按throws声明顺序排列。
在 Java 中，throws 声明的异常必须在 Javadoc 中用 @throws 标签明确说明，这是规范且必要的做法，尤其对公开 API 或团队协作项目而言。
语法格式要准确
@throws 后紧跟异常类的**全限定名**（如 java.io.IOException），后接空格和对该异常触发条件的简明描述。描述应聚焦于“什么情况下抛出”，而非重复异常类本身的含义。
- ✅ 正确：
@throws java.io.IOException 如果文件不存在或不可读 - ❌ 错误：
@throws IOException（缺描述）或@throws IOException 当发生 I/O 错误时（描述太笼统）
只写方法实际抛出的异常
仅对方法签名中 throws 明确声明的**检查型异常（checked exception）** 使用 @throws；运行时异常（如 NullPointerException、IllegalArgumentException）通常不强制写，除非其抛出是该方法的重要契约（例如参数校验失败时明确抛出 IllegalArgumentException 并需调用方知晓）。
- 必须写：
public void readFile() throws IOException, SQLException→ 对应两个@throws条目 - 可选但推荐写：
public void setName(String name) throws IllegalArgumentException→ 表明非空校验逻辑是公开行为
描述要具体、可操作
避免模糊表述，让调用者能据此做有效错误处理。优先说明前置条件或输入状态，而不是泛泛而谈“发生错误”。
- ⚠️ 模糊：
@throws SQLException 数据库操作失败 - ✅ 清晰：
@throws SQLException 当连接已关闭或 SQL 语句语法错误时 - ✅ 清晰：
@throws IllegalArgumentException 如果 url 为 null 或格式不合法
多个异常按 throws 子句顺序排列
Javadoc 中 @throws 的顺序建议与方法签名中 throws 列出的异常顺序一致，便于快速对照。虽然 Javadoc 工具不校验顺序，但保持一致提升可读性。
- 方法声明：
throws IOException, ParseException, SecurityException - Javadoc 中也按此顺序写三个
@throws行
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
