方法参数数量须≤3个（最多5个），超限需封装为JavaBean；main参数须用CLI库结构化解析；参数命名须具业务语义，基本类型优先用包装类，必填参数用requireNonNull校验，可选参数用Builder或Optional；引用类型默认只读，禁止原地修改。

方法参数数量要严格控制

团队统一规定：普通业务方法参数不超过3个，最多放宽至5个。超出即视为设计缺陷，必须封装为JavaBean对象。这不是可选项，而是硬性约束。例如签名加密方法若含证书、密码、参数、公钥、私钥等，直接拆成 SignRequest 类，字段命名清晰、类型明确、可复用、可校验。

main 方法参数需结构化处理

main(String[] args) 是程序对外接口，参数必须有规范解析逻辑。禁止直接用 args[0]、args[1] 硬编码取值。应统一使用命令行解析库（如 Apache Commons CLI 或 picocli），支持 --env=dev、-f config.yml 等语义化格式，并内置参数校验与帮助提示。启动脚本中也要同步维护参数说明，避免“改了代码却忘了更新文档”。

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

所有参数传递必须明确契约

每个方法签名要体现其职责边界：
- 参数名不能是 param1、obj 这类模糊命名，而应是 userId、orderStatus 等业务语义名
- 基本类型参数建议用包装类（如 Long 而非 long），便于表达 null 含义和空值校验
- 必填参数不得为 null，应在方法入口用 Objects.requireNonNull() 主动拦截
- 可选参数应通过 Builder 模式或 Optional 封装，不靠调用方“凭经验猜”

引用类型传参要守住不可变原则

Java 是值传递，但传的是引用的副本——这点必须全员理解。团队需约定：
- 方法内不得对入参集合做原地修改（如 list.add()），如需变更应返回新集合或显式标注 @Modifies
- 传入的 DTO/VO 对象默认视为只读，若需修改应复制后操作（如 new UserDTO(user)）
- 工具类方法（如日期格式化、字符串截断）必须保证无副作用，不依赖也不改变任何外部状态

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南