说明:AndroidStudio格式化时会格式化属性顺序属性顺序在File → Settings →Editor → Code Style → XML →Arrangement处配置默认顺序和下面的不一样建议默认顺序下面的仅供参考Android 布局 XML 属性顺序规范良好的 XML 属性排序能提升代码可读性和维护性。以下是 Android 布局属性推荐的书写顺序规范 推荐属性顺序ID 属性优先级最高android:id“id/控件名”布局相关属性按此顺序• 尺寸android:layout_width“”android:layout_height“”• 外边距android:layout_margin“”android:layout_marginStart|Left“”android:layout_marginTop“”android:layout_marginEnd|Right“”android:layout_marginBottom“”• 内边距android:padding“”android:paddingStart|Left“”android:paddingTop“”android:paddingEnd|Right“”android:paddingBottom“”• 位置/对齐android:layout_gravity“”android:layout_weight“”android:layout_centerInParent“”android:layout_alignParentTop“”• 相对布局约束ConstraintLayoutapp:layout_constraintStart_toStartOf“”app:layout_constraintTop_toTopOf“”视觉/内容属性• 文本相关android:text“”android:textColor“”android:textSize“”android:textStyle“”android:fontFamily“”• 背景/颜色android:background“”android:backgroundTint“”android:foreground“”• 图片/图标android:src“”android:icon“”• 可见性android:visibility“”交互/行为属性• 点击相关android:onClick“”android:clickable“”android:focusable“”• 滚动/列表相关android:scrollbars“”android:scrollbarStyle“”样式/主题属性放最后style“style/MyStyle”android:theme“” 完整示例Button android:idid/btn_submit android:layout_widthwrap_content android:layout_heightwrap_content android:layout_margin16dp android:paddingHorizontal24dp android:paddingVertical12dp android:text提交 android:textColorcolor/white android:textSize16sp android:textStylebold android:backgrounddrawable/btn_primary android:backgroundTintcolor/primary android:onClickonSubmitClick android:clickabletrue android:focusabletrue stylestyle/Widget.Button.Primary / ConstraintLayout 示例 Button android:idid/btn_confirm android:layout_width0dp android:layout_heightwrap_content android:layout_marginStart16dp android:layout_marginEnd16dp android:layout_marginBottom16dp android:padding12dp app:layout_constraintStart_toStartOfparent app:layout_constraintEnd_toEndOfparent app:layout_constraintBottom_toBottomOfparent android:text确认 android:textColorcolor/white android:textSize16sp android:backgrounddrawable/rounded_button android:onClickonConfirmClick stylestyle/PrimaryButton / 常用 View 类型的特定属性顺序TextView / Buttonid尺寸/布局属性文本属性背景/颜色交互属性样式ImageViewid尺寸/布局属性图片源缩放类型/调整背景交互属性样式RecyclerView / ListViewid尺寸/布局属性布局管理器/方向适配器相关分割线/动画交互属性样式 工具与自动格式化Android Studio 代码格式化• 使用 Ctrl Alt LWindows/Linux或 ⌥ ⌘ LMac• 在 Preferences → Editor → Code Style → XML → Arrangement 中可自定义排序规则自定义 Lint 检查可创建自定义 Lint 规则检查属性顺序// 在 build.gradle 中添加dependencies {lintChecks ‘com.github.AndroidCodeLinters:lint-rules:1.0.0’}第三方插件• https://plugins.jetbrains.com/plugin/17960-xml-formatter• 支持自定义属性排序规则 最佳实践建议团队一致性最重要无论采用何种顺序团队内部要保持一致按逻辑分组将相关属性放在一起如所有文本属性、所有边距属性从外到内• 先布局属性影响外部位置• 再内容属性内部显示• 最后交互属性行为注释分组对于复杂布局可使用注释分隔属性组android:layout_width“match_parent”android:text“标题”android:onClick“onTitleClick”命名空间顺序• android: 命名空间属性在前• app: 自定义/库属性在后• 工具属性 (tools:) 在最后 项目级配置示例在项目根目录创建 xml-attributes-order.txt 文件定义排序规则android:idandroid:layout_widthandroid:layout_heightandroid:layout_margin.*android:padding.*android:text.*android:background.*app:.*tools:.*style✅ 总结合理排序 XML 属性的好处• 提高可读性相关属性集中便于快速定位• 减少合并冲突统一格式减少不必要差异• 便于维护新成员更容易理解代码结构• 自动格式化工具支持更好核心原则外到内、先布局后内容、同类型属性集中、团队统一。
说明:AndroidStudio格式化时会格式化属性顺序属性顺序在File → Settings →Editor → Code Style → XML →Arrangement处配置默认顺序和下面的不一样建议默认顺序下面的仅供参考Android 布局 XML 属性顺序规范良好的 XML 属性排序能提升代码可读性和维护性。以下是 Android 布局属性推荐的书写顺序规范 推荐属性顺序ID 属性优先级最高android:id“id/控件名”布局相关属性按此顺序• 尺寸android:layout_width“”android:layout_height“”• 外边距android:layout_margin“”android:layout_marginStart|Left“”android:layout_marginTop“”android:layout_marginEnd|Right“”android:layout_marginBottom“”• 内边距android:padding“”android:paddingStart|Left“”android:paddingTop“”android:paddingEnd|Right“”android:paddingBottom“”• 位置/对齐android:layout_gravity“”android:layout_weight“”android:layout_centerInParent“”android:layout_alignParentTop“”• 相对布局约束ConstraintLayoutapp:layout_constraintStart_toStartOf“”app:layout_constraintTop_toTopOf“”视觉/内容属性• 文本相关android:text“”android:textColor“”android:textSize“”android:textStyle“”android:fontFamily“”• 背景/颜色android:background“”android:backgroundTint“”android:foreground“”• 图片/图标android:src“”android:icon“”• 可见性android:visibility“”交互/行为属性• 点击相关android:onClick“”android:clickable“”android:focusable“”• 滚动/列表相关android:scrollbars“”android:scrollbarStyle“”样式/主题属性放最后style“style/MyStyle”android:theme“” 完整示例Button android:idid/btn_submit android:layout_widthwrap_content android:layout_heightwrap_content android:layout_margin16dp android:paddingHorizontal24dp android:paddingVertical12dp android:text提交 android:textColorcolor/white android:textSize16sp android:textStylebold android:backgrounddrawable/btn_primary android:backgroundTintcolor/primary android:onClickonSubmitClick android:clickabletrue android:focusabletrue stylestyle/Widget.Button.Primary / ConstraintLayout 示例 Button android:idid/btn_confirm android:layout_width0dp android:layout_heightwrap_content android:layout_marginStart16dp android:layout_marginEnd16dp android:layout_marginBottom16dp android:padding12dp app:layout_constraintStart_toStartOfparent app:layout_constraintEnd_toEndOfparent app:layout_constraintBottom_toBottomOfparent android:text确认 android:textColorcolor/white android:textSize16sp android:backgrounddrawable/rounded_button android:onClickonConfirmClick stylestyle/PrimaryButton / 常用 View 类型的特定属性顺序TextView / Buttonid尺寸/布局属性文本属性背景/颜色交互属性样式ImageViewid尺寸/布局属性图片源缩放类型/调整背景交互属性样式RecyclerView / ListViewid尺寸/布局属性布局管理器/方向适配器相关分割线/动画交互属性样式 工具与自动格式化Android Studio 代码格式化• 使用 Ctrl Alt LWindows/Linux或 ⌥ ⌘ LMac• 在 Preferences → Editor → Code Style → XML → Arrangement 中可自定义排序规则自定义 Lint 检查可创建自定义 Lint 规则检查属性顺序// 在 build.gradle 中添加dependencies {lintChecks ‘com.github.AndroidCodeLinters:lint-rules:1.0.0’}第三方插件• https://plugins.jetbrains.com/plugin/17960-xml-formatter• 支持自定义属性排序规则 最佳实践建议团队一致性最重要无论采用何种顺序团队内部要保持一致按逻辑分组将相关属性放在一起如所有文本属性、所有边距属性从外到内• 先布局属性影响外部位置• 再内容属性内部显示• 最后交互属性行为注释分组对于复杂布局可使用注释分隔属性组android:layout_width“match_parent”android:text“标题”android:onClick“onTitleClick”命名空间顺序• android: 命名空间属性在前• app: 自定义/库属性在后• 工具属性 (tools:) 在最后 项目级配置示例在项目根目录创建 xml-attributes-order.txt 文件定义排序规则android:idandroid:layout_widthandroid:layout_heightandroid:layout_margin.*android:padding.*android:text.*android:background.*app:.*tools:.*style✅ 总结合理排序 XML 属性的好处• 提高可读性相关属性集中便于快速定位• 减少合并冲突统一格式减少不必要差异• 便于维护新成员更容易理解代码结构• 自动格式化工具支持更好核心原则外到内、先布局后内容、同类型属性集中、团队统一。
