java变量声明需遵循类型明确、及时初始化、命名规范、作用域最小化等原则：局部变量声明后立即赋值；常量用public static final和大写下划线；命名用小驼峰或全大写加下划线；数组符号[]紧跟类型；避免null，优先空集合；循环变量限于for内。
Java变量声明不是写完能跑就行的事，它直接影响代码可读性、协作效率和长期维护成本。团队开发中，统一规范比个人习惯更重要——尤其在多人共用模块、Code Review频繁、新人持续加入的场景下。
变量声明必须带明确类型和初始化
局部变量声明后必须立即赋值，或至少在首次使用前完成初始化。编译器不会给局部变量设默认值，未初始化就引用会直接报错。
- ✅ 推荐写法：int count = 0; 或 String userName = "unknown";
- ❌ 避免写法：int count; 后续才赋值，除非逻辑上确实需要延迟初始化（如 try-catch 中构造）
- 静态常量统一用 public static final，类型+大写下划线命名，如 public static final int MAX_RETRY_COUNT = 3;
命名要见名知意，严格区分作用域层级
名字不是越短越好，而是让队友看一眼就知道它干什么、在哪用、生命周期多长。
- 实例变量和局部变量都用小驼峰：userEmail、totalAmount
- 常量全大写加下划线：DEFAULT_TIMEOUT_MS、API_VERSION_V2
- 禁止用单字母（除 for 循环中的 i、j、k），也禁用模糊缩写如 usr、tmp、val
- 方法内避免遮蔽成员变量，比如不要在方法里声明同名的 name 去覆盖 this.name
数组和引用类型声明位置要统一
数组类型符号 [] 必须紧跟类型名，而不是变量名。这体现“类型即契约”的设计思想，也和泛型、函数式接口风格一致。
- ✅ 规范写法：String[] names;、List
orders; 、int[][] matrix; - ❌ 不推荐：String names[];（语法合法但易引发歧义，尤其在多维或复合声明时）
- 引用类型变量初始值为 null，但建议优先用空集合/空对象替代，如 Collections.emptyList() 而非 null
作用域最小化是硬性纪律
变量声明位置决定其可见范围。团队准则里应明文规定：只在真正需要的地方声明，绝不提前拉到方法顶部或类字段区占位。
- 循环变量写在 for 语句内：for (int i = 0; i
- 临时计算结果靠近使用处：String normalizedPath = path.replaceAll("/+", "/"); 紧挨着后续的 if (normalizedPath.startsWith("/api"))
- 避免把本该是局部变量的声明成 private 字段，除非它真属于对象状态（比如 private final Clock clock;）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
