Alibaba Java Coding Guidelines
阿里巴巴Java编码规范（Alibaba Java Coding Guidelines）是阿里技术团队多年实践总结的高质量代码指南，涵盖命名、注释、OOP、并发等核心场景，帮你写出更优雅的Java代码。
更新时间：2025-06-02 17:56:28
访问次数：233
Alibaba Java Coding Guidelines 是阿里巴巴集团推出的一套 Java 编码规范，旨在帮助开发者编写更规范、高质量的代码。以下是其主要内容和特点：
1. 核心规范
命名规则：
类名使用 UpperCamelCase（如
UserService）。方法名和变量名使用 lowerCamelCase（如
getUserId）。常量名使用 大写+下划线（如
MAX_CONNECTIONS）。包名使用 小写+单数形式（如
com.example.project）。避免使用拼音或中文命名。
代码格式：
使用 4个空格 缩进，禁止使用
Tab。大括号
{}需与语句同行，如if (condition) { ... }。运算符前后加空格（如
a + b）。单行代码不超过 120字符，超出需换行。
注释规范：
类、方法、变量需使用 Javadoc 注释（
/** ... */）。避免冗余注释，代码应自解释。
临时注释（如
TODO、FIXME）需标注作者和时间。2. 工具支持
IDE 插件（IntelliJ IDEA / Eclipse）：
IDEA：
Settings > Plugins，搜索 Alibaba Java Coding Guidelines 并安装。
Eclipse：通过
Help > Install New Software安装插件。
实时检测代码规范，并提供 Quick Fix 修复建议。
支持 PMD 静态分析，检测潜在问题（如未使用的变量、空
catch块等）。安装方式：
3. 最佳实践
OOP 规约：
覆写方法需加
@Override注解。避免使用过时的类或方法（如
new Date().getTime()应改用System.currentTimeMillis()）。POJO 类属性必须使用 包装类型（如
Integer而非int）。集合处理：
重写
equals()时必须重写hashCode()。禁止在
foreach循环中进行remove/add操作。并发与安全：
使用
ThreadPoolExecutor而非Executors创建线程池。用户敏感数据需脱敏（如手机号显示为
158****9119）。4. 资源
官方文档：
GitHub 项目地址（含 PMD 实现和 IDE 插件）。
《Java 开发手册（黄山版）》（最新规范）。
总结
Alibaba Java Coding Guidelines 通过 命名规范、代码格式、工具插件 和 最佳实践 提升代码质量，适用于个人开发者和企业团队。建议结合 IDE 插件实时检查，并参考官方手册深入学习。