Java变量声明需兼顾意图清晰、作用域可控、类型安全：命名用领域术语如customerPreferredName；声明即初始化避免空值陷阱；金额用BigDecimal、状态用枚举；作用域最小化，方法内变量紧邻使用处声明。
Java 变量声明不是写完能跑就行的事，它直接影响代码后期能不能加功能、改逻辑、接新模块。规范的声明方式让变量意图清晰、作用域可控、类型安全，是可扩展性的底层支撑。
变量命名必须表达业务含义
变量名不是代号，而是微型文档。用 userName 比用 str1 好，但真正体现可扩展性的是像 customerPreferredName 这样带上下文的命名。
- 避免泛化词：不用 data、info、temp，它们无法传达“谁的数据”“什么信息”“临时做什么”
- 优先使用领域术语：电商系统用 cartItemQuantity，不用 count；权限系统用 userRoleAssignmentStatus，不用 flag
- 布尔变量用 is/has/can 开头：如 isTwoFactorEnabled、hasUnreadNotifications，调用时语义自然，后续扩展条件分支也更直观
声明与初始化尽量合一，避免未定义状态
局部变量声明后不立即赋值，等于给代码埋下“空值陷阱”。尤其在新增分支逻辑或重构方法时，容易遗漏赋值路径，导致 NullPointerException 或默认值误用。
- 推荐写法：String orderStatus = "pending"; —— 状态明确，无需查上下文确认初始值
- 谨慎使用延迟初始化：仅当初始化开销大且非必走路径时（如缓存对象），才拆分为声明+后续赋值，并确保所有执行路径都有值
- 基本类型也要显式初始化：不要依赖 int count; 的默认 0，而写 int itemCount = 0;，避免将来改成包装类（Integer）时行为突变
类型选择兼顾当前需求与未来演进
用对类型，比用“能跑”更重要。比如一个表示“金额”的变量，别图省事用 double price;，它无法精确表示 0.1 元，也不支持货币单位切换。
立即学习“Java免费学习笔记（深入）”；
- 金额用 BigDecimal 或封装类（如 Money），预留精度控制和币种扩展能力
- 状态码优先用枚举：OrderStatus.PAID 比 int status = 2; 更安全，新增状态时只需加枚举项，不需改所有 switch 和判断逻辑
- 集合类型写明具体实现意图：需要线程安全？选 ConcurrentHashMap<String, User>；只读场景？初始化后用 Collections.unmodifiableMap() 封装，防止下游误修改
作用域最小化，为模块解耦打基础
变量作用域越大，越难替换、测试和复用。把本该在 if 块里用的变量提成类字段，等于把局部逻辑“固化”进整个类生命周期。
- 方法内变量一律声明在首次使用前，紧邻使用位置，不堆在方法顶部
- 避免“万能字段”：像 private Map<String, Object> context; 这类泛型容器，会阻碍静态分析、增加理解成本，也难以加校验或审计
- 跨方法共享数据，优先通过参数传递或返回值，而不是提升为实例变量——这样后续拆分服务、提取工具类、做单元测试都更顺畅
不复杂但容易忽略：变量声明不是语法练习，它是设计决策的第一落点。每多一分明确，后期就少三分重构成本。
