xiuyuantech 博客： https://xiuyuantech.github.io/
参考 Google 官方 Java 代码风格规范，中文翻译参考版链接。
本文档用于指导开发人员在项目开发过程中类名、资源文件名、变量名等开发约定以及命名规范，方便工程的后期维护，提高代码整体质量、可读性。
命名规范：
注意：即使纯拼音命名方式也要避免采用。但 alibaba、taobao、youku、hangzhou 等国际通用的名称, 可视同英文。
1、包命名
规则：包名全部小写，采用反域名命名规则，一级包名是顶级域名，通常为 com, edu, gov, net, org 等，二级包名，通过为公司名或部门名或者个人名，三级包名通常为项目名，四级包名为模块名或者层级名。
2、类命名
规则：采用大驼峰式命名法，首字母大写，尽量避免缩写，除非该缩写是众所周知的，比如 HTML，URL, 如果类名称包含单词缩写，则单词缩写的每个字母均应大写。以下列举的是 android 中几种最为常用的类的命名。
3、接口命名
规则：命名规则与类命名一样采用大驼峰式命名法，首字母大写，多以 able, ible, er 结尾。
注意：如果项目采用 MVP/MVI，所有 Model、View、Presenter/Intent 的接口都以 I 为前缀，不加后缀，其他的接口采用上述命名规则。
4、方法
规则：采用小驼峰命名法，首字母小写，方法名采用动词或动名词结构。方法的命名应该与方法的真正行为具有对应关系，下面给出一些方法名的动词前缀标示的建议。
getXX() 获取某个属性的返回值 ；setXX() 设置某个属性值 ；initXX() 初始化方法，如初始化布局 initView() ；isXX() 判断是否 true 的方法；
5、常量
规则：常量使用全大写字母加下划线的方式命名。
6、变量
规则：采用小驼峰命名法，首字母小写。变量名应简短且能描述其用途，尽量避免拼音，无意义地缩写。除非是临时变量，否则不建议使用单个字符的变量名，如 i, j, k。对于变量命名，还有一种风格是 google 的以字母 m 为前缀 （m 为 member 缩写），在 android 源码中随处可见。
更多还可参考阿里巴巴 Java 开发手册
注意：所有的 VO（值对象） 统一采用标准的 lowerCamelCase 风格编写，所有的 DTO（数据传输对象） 就按照接口文档中定义的字段名编写。
7、控件变量名
规则：首先需要满足第 6 条变量的规则， 模式：逻辑名 + view 缩写
8、控件 ID
规则：view 缩写模块名逻辑名
9、layout 的文件命名
规则：全部小写，采用下划线命名法。layout 文件命名：组件类型 {模块} 功能.xml
10、drawable 的文件命名
模式：前缀 {控件}{ 范围}{_后缀}，控件、范围、后缀可选
11、动画的文件命名
规则：模块名 {范围} 动画类型_动画方向。
12、strings.xml
模式：activity 名 {范围} 逻辑名
13、colors.xml
模式：前缀 {控件}{ 范围}{_后缀}， 控件、范围、后缀可选。
代码风格：
原则
不要直接忽略 Exceptions
import 采用完全限定名
if 括号风格
使用空格来缩进：使用 4 个空格缩进来代表块，而绝不使用 tab 键； 使用 8 个空格来代表行包裹，包括函数调用。
注释规范：
类注释
每个类完成后应该有作者姓名和联系方式的注释，对自己的代码负责。具体可以在 AS 中自己配制，Settings → Editor → File and Code Templates → Includes → File Header，输入自定义信息。
方法注释
每一个成员方法 （包括自定义成员方法、覆盖方法、属性方法） 的方法头都必须做方法头注释。
在方法前一行输入/** + 回车或者设置 Fix doc comment(Settings → Keymap → Fix doc comment) 快捷键，AS 便会帮你生成模板，我们只需要补全参数即可。
块注释
块注释与其周围的代码在同一缩进级别。它们可以是/* … /风格，也可以是// …风格 (//后最好带一个空格）。
对于多行的/ … /注释，后续行必须从开始， 并且与前一行的对齐。注释不要封闭在由星号或其它字符绘制的框架里。Tip：在写多行注释时，如果你希望在必要时能重新换行 (即注释像段落风格一样)，那么使用/ ... */。
资源文件注释 例如 ： <!--红色 -->
总结：
好的命名规则能够提高代码质量，使得新人加入时降低理解难度；
规矩终究是死的，适合团队的才是最好的；
命名规范需要团队齐心协力来维护，在团队里谁都不可能独善其身；
刚刚开始可能会有些不习惯，持之以恒，总会成功的。
业务咨询：https://soloist.pages.dev
原文地址：https://xiuyuantech.github.io/2026/03/19/android-rule/
