Java方法返回值必须明确声明类型，void表示无返回值，基本类型需确保所有路径返回值，引用类型推荐用Optional避免null，集合应返回空集合而非null，泛型需注意类型擦除问题。
Java方法返回值必须明确声明类型
Java是强类型语言，每个方法都必须显式声明返回类型，不能省略（void 除外）。不写返回类型会直接编译失败，不是警告——这是很多从Python或JS转来的开发者容易卡住的第一步。
-
void表示无返回值，此时方法体内不能有return后跟表达式（但可以写return;提前退出） - 返回基本类型（如
int、boolean）时，所有执行路径都必须有确定的return值，否则编译报错：missing return statement - 返回引用类型（如
String、List<String>）时，允许返回null，但需在文档或命名中体现可空性（例如用Optional<String>更安全）
用 Optional 包装可能为空的引用返回值
直接返回 null 容易引发 NullPointerException，尤其在链式调用中。JDK 8 引入的 Optional 是更明确的“可空性契约”。
public Optional<User> findUserById(Long id) {
User user = userRepository.findById(id);
return Optional.ofNullable(user);
}
- 调用方必须显式处理：用
.isPresent()、.orElse(...)或.ifPresent(...)，无法忽略空值风险 - 不要把
Optional当容器用（比如放在集合里、作为字段存储），它不是设计来持久化的 - 不要在 public API 中返回
Optional<T[]>或Optional<void>——后者语法非法，前者语义混乱
集合类返回值优先返回不可变视图或空集合而非 null
返回 null 迫使每个调用方重复判空，破坏封装性。标准做法是返回空集合（如 Collections.emptyList()）或不可变副本。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
public List<Order> getOrdersByStatus(String status) {
List<Order> orders = orderRepository.findByStatus(status);
return Collections.unmodifiableList(orders != null ? orders : Collections.emptyList());
}
- 用
Collections.emptyXxx()（如emptyList()、emptyMap()）比new ArrayList<>()更轻量，且线程安全 - 如果原始集合可能被外部修改，返回
unmodifiableXxx()避免调用方误改内部状态 - Spring Data JPA 的
findAll()等方法默认返回空List，不是null，这是行业实践基准
泛型方法返回值要避免类型擦除导致的运行时问题
Java 泛型在编译后会被擦除，所以 <T> T getValue() 这类方法无法在运行时知道 T 具体是什么类型，强制转型可能出错。
立即学习“Java免费学习笔记（深入）”；
- 若必须依赖运行时类型，传入
Class<T>参数辅助（如jsonMapper.readValue(json, String.class)） - 避免写
return (T) new Object();—— 这是典型的“泛型假安全”，编译通过但运行时可能 ClassCastException - 工具类中常用
@SuppressWarnings("unchecked")，但必须配注释说明为何安全（例如“此处 T 由调用方保证与实际类型一致”）
真正难的不是语法，而是判断“这个方法该不该返回 null”“调用方有没有能力/意愿处理 Optional”——这些得看团队共识和上下文，不是单靠规范能定的。
