1. 项目概述为什么Android开发者必须搞懂长度单位干了这么多年Android开发我敢说长度单位是每个开发者入门时都会遇到但又最容易掉以轻心、导致后期一堆麻烦的“基础”问题。你可能会想不就是px、dp、sp这几个缩写吗网上教程一抓一大把。但现实是我见过太多项目因为早期对单位使用不当到了适配各种奇奇怪怪屏幕尺寸和密度的时候UI直接崩掉修复起来牵一发而动全身成本巨大。简单来说px、dp、sp这三个单位是Android屏幕适配的基石。它们直接决定了你的按钮大小、文字尺寸、间距宽窄在不同手机屏幕上看起来是协调一致还是“胖瘦不一”。特别是现在手机屏幕从4英寸到7英寸像素密度DPI从ldpi到xxxhdpi还有各种折叠屏、平板设备如果没有一个正确的单位体系作为标尺你的应用界面将是一场灾难。这篇文章我会从一个老码农的实战视角彻底掰开揉碎这几个单位。不止告诉你它们是什么更要讲清楚在什么场景下必须用哪个为什么这么用以及我踩过的那些坑。无论你是刚接触Android的新手还是已经写过一些代码但对适配仍感模糊的开发者这篇详解都能帮你建立起清晰、坚固的认知让你写出的UI能从容应对市面上绝大多数的设备。2. 核心概念深度解析px、dp、sp的本质区别2.1 px像素最原始也最“危险”的尺子px是Pixel像素的缩写。这是最直观的单位你的屏幕就是由无数个发光点像素组成的矩阵。在代码里设置一个View的宽度为100px意思就是让它占据屏幕上横向的100个物理像素点。听起来很直接对吧但它的“危险”也正在于此。px是一个绝对单位它不关心屏幕的物理尺寸和像素密度。我举个例子你就明白了假设有两台手机屏幕宽度在代码里读取都是1080px即1080像素。但手机A是5英寸屏手机B是6.5英寸屏。你画一个100px宽的按钮在这两台手机上它占据的物理宽度是完全不同的在5英寸的小屏上这个按钮会显得很大、很蠢在6.5英寸的大屏上它又会显得很小、很难点按。更复杂的是像素密度DPI。一个100px的图片在低密度ldpi约120dpi屏幕上可能实际物理尺寸很大但在超高密度xxxhdpi约640dpi的屏幕上同样的100px会变得非常小。如果你全部用px来布局那你的应用界面在不同设备上的物理尺寸会完全失控。实操心得在如今的Android开发中几乎禁止在布局文件XML或设置尺寸的Java/Kotlin代码中直接使用px。它唯一的合理存在场景可能是在处理极底层、与屏幕物理像素直接相关的图形绘制Canvas绘图时但即便如此也通常需要结合密度进行换算。新手最容易犯的错误就是从网上抄一段代码里面用了px然后不加思考就用在自己的项目里为日后适配埋下大雷。2.2 dp密度无关像素Android适配的“标准答案”dpDensity-independent Pixel在较早的文档中也叫dip是Android设计用来解决px适配问题的核心单位。你可以把它理解为一个“虚拟像素”。它的设计目标很明确让一个dp单位在不同密度的屏幕上看起来的物理尺寸大致相同。系统会负责这个魔法般的转换。它的换算基准是在160dpi即mdpi中等密度的屏幕上1dp 1px。这是Android定义的“标准密度”。对于其他密度的屏幕在hdpi~240dpi上1dp ≈ 1.5px在xhdpi~320dpi上1dp ≈ 2px在xxhdpi~480dpi上1dp ≈ 3px在xxxhdpi~640dpi上1dp ≈ 4px系统内部有一个叫做密度系数density的值对于mdpi设备它是1.0xhdpi是2.0以此类推。当你定义了一个View的宽度是100dp时系统在渲染时会自动计算实际像素值 dp值 * density。这样100dp的按钮在mdpi屏上占100个物理像素在xhdpi屏上占200个物理像素。由于xhdpi屏幕的像素更密集这200个像素的物理宽度会和mdpi屏上100个像素的物理宽度非常接近。所以dp是用来定义非文字类UI元素尺寸的黄金标准。比如按钮的宽高、ImageView的大小、布局的margin和padding、分割线的粗细等。使用dp可以保证你的UI在不同密度设备上物理尺寸基本一致。2.3 sp缩放独立像素专为文字设计的智能单位spScale-independent Pixel可以看作是dp为文字定制的一个“特别版”。它继承了dp的所有密度无关特性但额外增加了一个维度用户系统的字体大小偏好。也就是说1sp在物理尺寸上和1dp是等价的但sp会乘以用户在系统设置中调整的“字体缩放比例”。如果用户觉得默认字太小去设置里调成了“大号”那么这个比例可能是1.2或1.3。你用sp定义的文字大小就会随之变大而用dp定义的其他UI元素尺寸则保持不变。这就是sp存在的唯一且最重要的意义尊重用户的视觉可访问性选择。有些用户视力不好需要调大字体。如果你用dp来定义文字大小那么即使用户调了系统字体你应用里的字也不会变大体验极差。如果你用px那更是灾难。所以规则非常简单且强制所有设置文字尺寸的地方必须使用sp单位。这包括TextView的textSize以及任何可能显示文本的自定义View中与字体相关的尺寸。注意事项这里有一个常见的误解和坑点。sp只影响TextView中textSize属性定义的文本绘制区域的缩放。它不会自动缩放TextView控件本身的布局高度layout_height如果你写了一个高度为50dp的Button里面的文字用16sp。当用户把字体调到最大时16sp的文字实际渲染高度可能会超过50dp导致文字被截断clipped。因此对于可能包含动态文本或需要支持大字体的控件其高度layout_height应该设置为wrap_content或一个足够大的dp值而不是一个固定死的小值。3. 在Android Studio中的实操与应用3.1 在XML布局文件中正确使用单位在res/layout/目录下的XML文件中定义尺寸属性时直接加上单位后缀即可。Button android:layout_width100dp !-- 按钮宽度用dp -- android:layout_heightwrap_content !-- 高度包裹内容自适应 -- android:textSize16sp !-- 文字大小必须用sp -- android:text确定 android:paddingStart16dp !-- 内边距用dp -- android:paddingEnd16dp android:layout_marginTop8dp / !-- 外边距用dp -- View android:layout_widthmatch_parent android:layout_height1dp !-- 分割线高度很细的线用1dp -- android:background#CCCCCC /Android Studio的预览工具Preview是你最好的朋友。你可以通过预览面板左上角的下拉菜单快速切换不同的设备配置如不同的屏幕尺寸、密度、字体大小实时查看你的dp和sp布局效果而无需每次都启动模拟器。3.2 在Java/Kotlin代码中动态设置尺寸有时我们需要在代码里动态计算或设置一个尺寸。切记不要直接传入一个整型数字那会被系统认为是px正确的方法是使用dp或sp到px的转换。Android提供了TypedValue类和DisplayMetrics来辅助完成。Kotlin示例import android.util.TypedValue // 将 50dp 转换为当前设备所需的像素值 val dpValue 50 val pixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_DIP, // 单位类型DIP就是DP dpValue.toFloat(), resources.displayMetrics ) someView.layoutParams.width pixelValue.toInt() // 将 16sp 转换为像素值用于非TextView的复杂计算TextView直接setTextSize即可 val spValue 16 val spPixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_SP, spValue.toFloat(), resources.displayMetrics )Java示例import android.util.TypedValue; int dpValue 50; float pixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_DIP, dpValue, getResources().getDisplayMetrics() ); someView.getLayoutParams().width (int) pixelValue;对于TextView有更简单的方法来设置sp单位的大小// 方法一直接设置sp值推荐 textView.textSize 16f // 注意默认单位就是sp这里16f就是16sp // 方法二通过资源设置兼容性更好 textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)核心技巧在代码中TextView的setTextSize方法有一个巨坑它的重载方法setTextSize(float size)这个size参数的单位默认是sp在API中注明是“scaled pixel”。但是另一个重载setTextSize(int unit, float size)需要你明确指定单位。很多新手包括当年的我会误以为setTextSize(16)是设置16px实际上它设置了16sp可能导致在代码和XML中单位不一致的混乱。最安全的做法是无论在XML还是代码中都统一使用sp并在代码中明确使用setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)。3.3 资源限定符与多屏幕适配仅仅使用dp和sp并不能解决所有适配问题尤其是当屏幕的物理尺寸英寸差异很大时。例如一个100dp宽的按钮在5英寸手机和10英寸平板上物理宽度虽然接近但相对于屏幕总宽度的比例却相差甚远。在平板上会显得非常窄小。这时就需要结合资源限定符来提供不同的布局或尺寸值。Android允许你为不同配置屏幕宽度、高度、方向等提供不同的资源文件。为不同屏幕宽度提供不同的尺寸值在res/values/目录下的dimens.xml中定义基准尺寸。!-- res/values/dimens.xml -- resources dimen namekey_button_width100dp/dimen dimen nametext_heading_size20sp/dimen /resources为宽度大于600dp的设备通常是7英寸平板创建新的尺寸文件。!-- res/values-w600dp/dimens.xml -- resources dimen namekey_button_width150dp/dimen !-- 在平板上按钮更宽 -- dimen nametext_heading_size22sp/dimen !-- 标题字稍大 -- /resources在布局或代码中引用dimen/key_button_width系统会根据当前设备的屏幕宽度自动选择正确的值。这种策略称为宽度限定符适配现在更推荐使用最小宽度限定符即swNdp如values-sw600dp它是实现跨手机和平板适配的主流方案。它和dp/sp单位是相辅相成的关系dp/sp解决了密度适配问题而资源限定符解决了尺寸和比例适配问题。4. 高级话题与常见陷阱排查4.1 获取屏幕密度信息与手动计算了解如何获取和计算这些值有助于调试复杂的UI问题。val metrics resources.displayMetrics val densityDpi metrics.densityDpi // 屏幕密度DPI值如 320, 480 val density metrics.density // 密度系数mdpi1.0, xhdpi2.0 val scaledDensity metrics.scaledDensity // 用于sp的缩放密度通常等于density但会随系统字体大小设置变化 val screenWidthPx metrics.widthPixels // 屏幕宽度像素 val screenHeightPx metrics.heightPixels // 屏幕高度像素 // 将像素宽度转换为dp宽度用于理解当前屏幕的“dp容量” val screenWidthDp screenWidthPx / density val screenHeightDp screenHeightPx / density Log.d(ScreenInfo, 密度: $densityDpi dpi, 系数: $density, 屏幕宽: ${screenWidthDp}dp)4.2 图片资源的适配drawable与mipmap长度单位的概念也紧密关联着图片资源的适配。你绝不能只准备一张高分辨率图片就指望它在所有设备上都能清晰显示。Android的drawable和mipmap目录使用密度限定符来管理图片drawable-mdpi/mipmap-mdpi(约160dpi)drawable-hdpi/mipmap-hdpi(约240dpi)drawable-xhdpi/mipmap-xhdpi(约320dpi)drawable-xxhdpi/mipmap-xxhdpi(约480dpi)drawable-xxxhdpi/mipmap-xxxhdpi(约640dpi)规则是你为ImageView设置一个宽100dp, 高100dp。系统会根据当前设备的密度自动从对应的目录选取图片。如果设备是xxhdpi它会去drawable-xxhdpi里找图。这张图的尺寸应该是300px * 300px因为100dp * 3.0 300px。这样图片在屏幕上就能以正确的物理尺寸和清晰度显示。避坑指南mipmap目录通常只用于应用图标ic_launcher因为一些设备如启动器可能会在非标准密度下使用图标。其他所有UI图片都应放在drawable目录下。混用会导致管理混乱和潜在的性能或内存问题。4.3 常见问题排查实录问题1为什么我的布局在预览里和真机上不一样可能原因1预览选择的设备配置和真机不一致。检查预览面板顶部的设备型号、API版本、屏幕尺寸和密度是否匹配。可能原因2使用了px单位。在XML中全局搜索“px”确保所有尺寸和文字大小都是dp或sp。可能原因3依赖了未提供的密度资源。例如你的应用主要提供了xxhdpi的图片但运行在一个mdpi的老旧设备上。系统会缩放xxhdpi的图片下来用可能导致模糊同时计算布局时使用的density值不同导致dp转换后的像素值与预览有差异。问题2文字显示不全或被截断。排查步骤确认TextView的textSize用的是sp。检查TextView的layout_height是否设置了固定值如50dp。如果是尝试改为wrap_content。检查是否有maxLines或ellipsize属性限制。在系统设置中调大字体在真机上复现问题。这是测试sp单位是否生效以及布局容错性的标准操作。问题31dp的分割线在某些设备上看不见或太粗。原因与解决1dp是逻辑上的最小单位。在超高密度屏如xxxhdpi,density4上1dp会渲染为4px一条4像素的线是清晰可见的。但在低密度屏如ldpi,density0.75上1dp会渲染为0.75px系统可能进行亚像素渲染或取整导致显示异常看不见或断续。对于分割线一个更稳健的做法是使用一个高度为1px的View但将其背景色设置为半透明如#1A000000这样它在任何密度下都是一条物理像素的细线只是颜色深浅略有变化视觉上更统一。问题4WebView或自定义View中的单位混乱。场景在WebView中加载的HTML页面或者自己在Canvas上绘图时其内部使用的往往是px。解决思路需要建立一个桥梁进行转换。对于WebView可以通过JavaScript接口将设备的density传递给前端让前端CSS使用rem等相对单位并基于此密度进行缩放。对于自定义Canvas绘图在计算坐标和尺寸时需要先将设计稿中的dp值通常UI给的是基于某个基准密度的px图需要除以基准密度得到dp通过TypedValue.applyDimension转换为当前设备的px值再进行绘制。5. 工具、工作流与最佳实践5.1 设计稿Sketch/Figma到代码的转换UI设计师通常使用px作为设计工具的单位。你需要一个清晰的转换规则与设计师沟通。标准流程确定基准密度通常以xxhdpi1080x1920 420dpi左右或xhdpi720x1280作为设计基准。目前行业更倾向于xxhdpi因为这是主流安卓机的密度。获取设计稿标注设计师给出一个按钮宽度为300px在xxhdpi画布上。计算dp值如果基准是xxhdpi密度系数约为3那么dp值 px值 / 3。所以300px / 3 100dp。你在代码中就应该设置这个按钮的宽度为100dp。提供切图你需要针对不同密度向设计师索取或自己生成切图。对于上面的例子你需要drawable-xxhdpi下的图片300px * 300pxdrawable-xhdpi下的图片200px * 200px(300 / 3 * 2)drawable-hdpi下的图片150px * 150px(300 / 3 * 1.5)drawable-mdpi下的图片100px * 100px(300 / 3 * 1)现在很多设计工具如Figma的插件或在线标注平台如蓝湖、摹客可以直接显示dp/sp值大大提升了协作效率。5.2 使用ConstraintLayout减少对固定尺寸的依赖现代Android布局强烈推荐使用ConstraintLayout。它的一个核心思想是使用约束关系如app:layout_constraintStart_toStartOfparent、app:layout_constraintEnd_toEndOfparent和比例如app:layout_constraintDimensionRatioH,16:9来定义位置和大小而不是大量使用固定的dp值。例如让一个按钮的宽度占屏幕宽度的50%Button android:idid/button android:layout_width0dp !-- 在ConstraintLayout中0dp表示“匹配约束” -- android:layout_heightwrap_content app:layout_constraintStart_toStartOfparent app:layout_constraintEnd_toEndOfparent app:layout_constraintWidth_defaultpercent app:layout_constraintWidth_percent0.5 / !-- 宽度为父容器的50% --这种方式能更好地适应不同宽度的屏幕比写死一个200dp要灵活和可靠得多。5.3 建立项目的尺寸规范体系在一个中大型项目中不应该在布局文件中到处写散落的dp和sp值。应该建立一个统一的尺寸资源文件dimens.xml。!-- res/values/dimens.xml -- resources !-- 间距系统 -- dimen namespacing_tiny4dp/dimen dimen namespacing_small8dp/dimen dimen namespacing_medium16dp/dimen dimen namespacing_large24dp/dimen dimen namespacing_huge32dp/dimen !-- 字体大小系统 -- dimen nametext_size_caption12sp/dimen dimen nametext_size_body14sp/dimen dimen nametext_size_subtitle16sp/dimen dimen nametext_size_title20sp/dimen dimen nametext_size_headline24sp/dimen !-- 控件标准尺寸 -- dimen namebutton_height_standard48dp/dimen dimen nameicon_size_small24dp/dimen dimen nameicon_size_medium32dp/dimen /resources然后在布局中引用dimen/spacing_medium。这样做的好处是保持一致性整个应用的间距、字体大小有统一的视觉节奏。易于修改如果需要调整整个应用的间距尺度只需修改一个文件。便于适配可以轻松地为values-sw600dp创建另一个dimens.xml定义一套适合平板的尺寸规范。5.4 测试策略覆盖你的密度和尺寸不要只在你自己的高清手机上测试。建立一套有效的测试矩阵密度测试确保在hdpi(240dpi)、xhdpi(320dpi)、xxhdpi(480dpi) 等不同密度的模拟器或真机上运行检查图片是否清晰布局是否错乱。字体缩放测试在手机的系统设置中将字体大小从“小”调到“巨大”然后打开你的应用。检查所有文字是否可见、是否被截断、布局是否被撑坏。屏幕尺寸测试使用屏幕宽度差异巨大的设备进行测试如小屏手机sw320dp、主流手机sw360dp-400dp、大屏手机/小平板sw600dp、平板sw720dp。检查布局是否充分利用了空间还是显得过于拥挤或空旷。理解并熟练运用px、dp、sp是构建一个健壮、美观、用户体验一致的Android应用的起点。它远不止是记忆几个缩写而是建立一种与设备多样性共存的思维方式。从今天起在写每一行布局代码时都问自己一句“我这里用的单位对吗” 
长河君 · 2026/8/4 9:13:23 · 阅读 1.2k Android屏幕适配核心：px、dp、sp单位详解与实战避坑指南
1. 项目概述为什么Android开发者必须搞懂长度单位干了这么多年Android开发我敢说长度单位是每个开发者入门时都会遇到但又最容易掉以轻心、导致后期一堆麻烦的“基础”问题。你可能会想不就是px、dp、sp这几个缩写吗网上教程一抓一大把。但现实是我见过太多项目因为早期对单位使用不当到了适配各种奇奇怪怪屏幕尺寸和密度的时候UI直接崩掉修复起来牵一发而动全身成本巨大。简单来说px、dp、sp这三个单位是Android屏幕适配的基石。它们直接决定了你的按钮大小、文字尺寸、间距宽窄在不同手机屏幕上看起来是协调一致还是“胖瘦不一”。特别是现在手机屏幕从4英寸到7英寸像素密度DPI从ldpi到xxxhdpi还有各种折叠屏、平板设备如果没有一个正确的单位体系作为标尺你的应用界面将是一场灾难。这篇文章我会从一个老码农的实战视角彻底掰开揉碎这几个单位。不止告诉你它们是什么更要讲清楚在什么场景下必须用哪个为什么这么用以及我踩过的那些坑。无论你是刚接触Android的新手还是已经写过一些代码但对适配仍感模糊的开发者这篇详解都能帮你建立起清晰、坚固的认知让你写出的UI能从容应对市面上绝大多数的设备。2. 核心概念深度解析px、dp、sp的本质区别2.1 px像素最原始也最“危险”的尺子px是Pixel像素的缩写。这是最直观的单位你的屏幕就是由无数个发光点像素组成的矩阵。在代码里设置一个View的宽度为100px意思就是让它占据屏幕上横向的100个物理像素点。听起来很直接对吧但它的“危险”也正在于此。px是一个绝对单位它不关心屏幕的物理尺寸和像素密度。我举个例子你就明白了假设有两台手机屏幕宽度在代码里读取都是1080px即1080像素。但手机A是5英寸屏手机B是6.5英寸屏。你画一个100px宽的按钮在这两台手机上它占据的物理宽度是完全不同的在5英寸的小屏上这个按钮会显得很大、很蠢在6.5英寸的大屏上它又会显得很小、很难点按。更复杂的是像素密度DPI。一个100px的图片在低密度ldpi约120dpi屏幕上可能实际物理尺寸很大但在超高密度xxxhdpi约640dpi的屏幕上同样的100px会变得非常小。如果你全部用px来布局那你的应用界面在不同设备上的物理尺寸会完全失控。实操心得在如今的Android开发中几乎禁止在布局文件XML或设置尺寸的Java/Kotlin代码中直接使用px。它唯一的合理存在场景可能是在处理极底层、与屏幕物理像素直接相关的图形绘制Canvas绘图时但即便如此也通常需要结合密度进行换算。新手最容易犯的错误就是从网上抄一段代码里面用了px然后不加思考就用在自己的项目里为日后适配埋下大雷。2.2 dp密度无关像素Android适配的“标准答案”dpDensity-independent Pixel在较早的文档中也叫dip是Android设计用来解决px适配问题的核心单位。你可以把它理解为一个“虚拟像素”。它的设计目标很明确让一个dp单位在不同密度的屏幕上看起来的物理尺寸大致相同。系统会负责这个魔法般的转换。它的换算基准是在160dpi即mdpi中等密度的屏幕上1dp 1px。这是Android定义的“标准密度”。对于其他密度的屏幕在hdpi~240dpi上1dp ≈ 1.5px在xhdpi~320dpi上1dp ≈ 2px在xxhdpi~480dpi上1dp ≈ 3px在xxxhdpi~640dpi上1dp ≈ 4px系统内部有一个叫做密度系数density的值对于mdpi设备它是1.0xhdpi是2.0以此类推。当你定义了一个View的宽度是100dp时系统在渲染时会自动计算实际像素值 dp值 * density。这样100dp的按钮在mdpi屏上占100个物理像素在xhdpi屏上占200个物理像素。由于xhdpi屏幕的像素更密集这200个像素的物理宽度会和mdpi屏上100个像素的物理宽度非常接近。所以dp是用来定义非文字类UI元素尺寸的黄金标准。比如按钮的宽高、ImageView的大小、布局的margin和padding、分割线的粗细等。使用dp可以保证你的UI在不同密度设备上物理尺寸基本一致。2.3 sp缩放独立像素专为文字设计的智能单位spScale-independent Pixel可以看作是dp为文字定制的一个“特别版”。它继承了dp的所有密度无关特性但额外增加了一个维度用户系统的字体大小偏好。也就是说1sp在物理尺寸上和1dp是等价的但sp会乘以用户在系统设置中调整的“字体缩放比例”。如果用户觉得默认字太小去设置里调成了“大号”那么这个比例可能是1.2或1.3。你用sp定义的文字大小就会随之变大而用dp定义的其他UI元素尺寸则保持不变。这就是sp存在的唯一且最重要的意义尊重用户的视觉可访问性选择。有些用户视力不好需要调大字体。如果你用dp来定义文字大小那么即使用户调了系统字体你应用里的字也不会变大体验极差。如果你用px那更是灾难。所以规则非常简单且强制所有设置文字尺寸的地方必须使用sp单位。这包括TextView的textSize以及任何可能显示文本的自定义View中与字体相关的尺寸。注意事项这里有一个常见的误解和坑点。sp只影响TextView中textSize属性定义的文本绘制区域的缩放。它不会自动缩放TextView控件本身的布局高度layout_height如果你写了一个高度为50dp的Button里面的文字用16sp。当用户把字体调到最大时16sp的文字实际渲染高度可能会超过50dp导致文字被截断clipped。因此对于可能包含动态文本或需要支持大字体的控件其高度layout_height应该设置为wrap_content或一个足够大的dp值而不是一个固定死的小值。3. 在Android Studio中的实操与应用3.1 在XML布局文件中正确使用单位在res/layout/目录下的XML文件中定义尺寸属性时直接加上单位后缀即可。Button android:layout_width100dp !-- 按钮宽度用dp -- android:layout_heightwrap_content !-- 高度包裹内容自适应 -- android:textSize16sp !-- 文字大小必须用sp -- android:text确定 android:paddingStart16dp !-- 内边距用dp -- android:paddingEnd16dp android:layout_marginTop8dp / !-- 外边距用dp -- View android:layout_widthmatch_parent android:layout_height1dp !-- 分割线高度很细的线用1dp -- android:background#CCCCCC /Android Studio的预览工具Preview是你最好的朋友。你可以通过预览面板左上角的下拉菜单快速切换不同的设备配置如不同的屏幕尺寸、密度、字体大小实时查看你的dp和sp布局效果而无需每次都启动模拟器。3.2 在Java/Kotlin代码中动态设置尺寸有时我们需要在代码里动态计算或设置一个尺寸。切记不要直接传入一个整型数字那会被系统认为是px正确的方法是使用dp或sp到px的转换。Android提供了TypedValue类和DisplayMetrics来辅助完成。Kotlin示例import android.util.TypedValue // 将 50dp 转换为当前设备所需的像素值 val dpValue 50 val pixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_DIP, // 单位类型DIP就是DP dpValue.toFloat(), resources.displayMetrics ) someView.layoutParams.width pixelValue.toInt() // 将 16sp 转换为像素值用于非TextView的复杂计算TextView直接setTextSize即可 val spValue 16 val spPixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_SP, spValue.toFloat(), resources.displayMetrics )Java示例import android.util.TypedValue; int dpValue 50; float pixelValue TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_DIP, dpValue, getResources().getDisplayMetrics() ); someView.getLayoutParams().width (int) pixelValue;对于TextView有更简单的方法来设置sp单位的大小// 方法一直接设置sp值推荐 textView.textSize 16f // 注意默认单位就是sp这里16f就是16sp // 方法二通过资源设置兼容性更好 textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)核心技巧在代码中TextView的setTextSize方法有一个巨坑它的重载方法setTextSize(float size)这个size参数的单位默认是sp在API中注明是“scaled pixel”。但是另一个重载setTextSize(int unit, float size)需要你明确指定单位。很多新手包括当年的我会误以为setTextSize(16)是设置16px实际上它设置了16sp可能导致在代码和XML中单位不一致的混乱。最安全的做法是无论在XML还是代码中都统一使用sp并在代码中明确使用setTextSize(TypedValue.COMPLEX_UNIT_SP, 16f)。3.3 资源限定符与多屏幕适配仅仅使用dp和sp并不能解决所有适配问题尤其是当屏幕的物理尺寸英寸差异很大时。例如一个100dp宽的按钮在5英寸手机和10英寸平板上物理宽度虽然接近但相对于屏幕总宽度的比例却相差甚远。在平板上会显得非常窄小。这时就需要结合资源限定符来提供不同的布局或尺寸值。Android允许你为不同配置屏幕宽度、高度、方向等提供不同的资源文件。为不同屏幕宽度提供不同的尺寸值在res/values/目录下的dimens.xml中定义基准尺寸。!-- res/values/dimens.xml -- resources dimen namekey_button_width100dp/dimen dimen nametext_heading_size20sp/dimen /resources为宽度大于600dp的设备通常是7英寸平板创建新的尺寸文件。!-- res/values-w600dp/dimens.xml -- resources dimen namekey_button_width150dp/dimen !-- 在平板上按钮更宽 -- dimen nametext_heading_size22sp/dimen !-- 标题字稍大 -- /resources在布局或代码中引用dimen/key_button_width系统会根据当前设备的屏幕宽度自动选择正确的值。这种策略称为宽度限定符适配现在更推荐使用最小宽度限定符即swNdp如values-sw600dp它是实现跨手机和平板适配的主流方案。它和dp/sp单位是相辅相成的关系dp/sp解决了密度适配问题而资源限定符解决了尺寸和比例适配问题。4. 高级话题与常见陷阱排查4.1 获取屏幕密度信息与手动计算了解如何获取和计算这些值有助于调试复杂的UI问题。val metrics resources.displayMetrics val densityDpi metrics.densityDpi // 屏幕密度DPI值如 320, 480 val density metrics.density // 密度系数mdpi1.0, xhdpi2.0 val scaledDensity metrics.scaledDensity // 用于sp的缩放密度通常等于density但会随系统字体大小设置变化 val screenWidthPx metrics.widthPixels // 屏幕宽度像素 val screenHeightPx metrics.heightPixels // 屏幕高度像素 // 将像素宽度转换为dp宽度用于理解当前屏幕的“dp容量” val screenWidthDp screenWidthPx / density val screenHeightDp screenHeightPx / density Log.d(ScreenInfo, 密度: $densityDpi dpi, 系数: $density, 屏幕宽: ${screenWidthDp}dp)4.2 图片资源的适配drawable与mipmap长度单位的概念也紧密关联着图片资源的适配。你绝不能只准备一张高分辨率图片就指望它在所有设备上都能清晰显示。Android的drawable和mipmap目录使用密度限定符来管理图片drawable-mdpi/mipmap-mdpi(约160dpi)drawable-hdpi/mipmap-hdpi(约240dpi)drawable-xhdpi/mipmap-xhdpi(约320dpi)drawable-xxhdpi/mipmap-xxhdpi(约480dpi)drawable-xxxhdpi/mipmap-xxxhdpi(约640dpi)规则是你为ImageView设置一个宽100dp, 高100dp。系统会根据当前设备的密度自动从对应的目录选取图片。如果设备是xxhdpi它会去drawable-xxhdpi里找图。这张图的尺寸应该是300px * 300px因为100dp * 3.0 300px。这样图片在屏幕上就能以正确的物理尺寸和清晰度显示。避坑指南mipmap目录通常只用于应用图标ic_launcher因为一些设备如启动器可能会在非标准密度下使用图标。其他所有UI图片都应放在drawable目录下。混用会导致管理混乱和潜在的性能或内存问题。4.3 常见问题排查实录问题1为什么我的布局在预览里和真机上不一样可能原因1预览选择的设备配置和真机不一致。检查预览面板顶部的设备型号、API版本、屏幕尺寸和密度是否匹配。可能原因2使用了px单位。在XML中全局搜索“px”确保所有尺寸和文字大小都是dp或sp。可能原因3依赖了未提供的密度资源。例如你的应用主要提供了xxhdpi的图片但运行在一个mdpi的老旧设备上。系统会缩放xxhdpi的图片下来用可能导致模糊同时计算布局时使用的density值不同导致dp转换后的像素值与预览有差异。问题2文字显示不全或被截断。排查步骤确认TextView的textSize用的是sp。检查TextView的layout_height是否设置了固定值如50dp。如果是尝试改为wrap_content。检查是否有maxLines或ellipsize属性限制。在系统设置中调大字体在真机上复现问题。这是测试sp单位是否生效以及布局容错性的标准操作。问题31dp的分割线在某些设备上看不见或太粗。原因与解决1dp是逻辑上的最小单位。在超高密度屏如xxxhdpi,density4上1dp会渲染为4px一条4像素的线是清晰可见的。但在低密度屏如ldpi,density0.75上1dp会渲染为0.75px系统可能进行亚像素渲染或取整导致显示异常看不见或断续。对于分割线一个更稳健的做法是使用一个高度为1px的View但将其背景色设置为半透明如#1A000000这样它在任何密度下都是一条物理像素的细线只是颜色深浅略有变化视觉上更统一。问题4WebView或自定义View中的单位混乱。场景在WebView中加载的HTML页面或者自己在Canvas上绘图时其内部使用的往往是px。解决思路需要建立一个桥梁进行转换。对于WebView可以通过JavaScript接口将设备的density传递给前端让前端CSS使用rem等相对单位并基于此密度进行缩放。对于自定义Canvas绘图在计算坐标和尺寸时需要先将设计稿中的dp值通常UI给的是基于某个基准密度的px图需要除以基准密度得到dp通过TypedValue.applyDimension转换为当前设备的px值再进行绘制。5. 工具、工作流与最佳实践5.1 设计稿Sketch/Figma到代码的转换UI设计师通常使用px作为设计工具的单位。你需要一个清晰的转换规则与设计师沟通。标准流程确定基准密度通常以xxhdpi1080x1920 420dpi左右或xhdpi720x1280作为设计基准。目前行业更倾向于xxhdpi因为这是主流安卓机的密度。获取设计稿标注设计师给出一个按钮宽度为300px在xxhdpi画布上。计算dp值如果基准是xxhdpi密度系数约为3那么dp值 px值 / 3。所以300px / 3 100dp。你在代码中就应该设置这个按钮的宽度为100dp。提供切图你需要针对不同密度向设计师索取或自己生成切图。对于上面的例子你需要drawable-xxhdpi下的图片300px * 300pxdrawable-xhdpi下的图片200px * 200px(300 / 3 * 2)drawable-hdpi下的图片150px * 150px(300 / 3 * 1.5)drawable-mdpi下的图片100px * 100px(300 / 3 * 1)现在很多设计工具如Figma的插件或在线标注平台如蓝湖、摹客可以直接显示dp/sp值大大提升了协作效率。5.2 使用ConstraintLayout减少对固定尺寸的依赖现代Android布局强烈推荐使用ConstraintLayout。它的一个核心思想是使用约束关系如app:layout_constraintStart_toStartOfparent、app:layout_constraintEnd_toEndOfparent和比例如app:layout_constraintDimensionRatioH,16:9来定义位置和大小而不是大量使用固定的dp值。例如让一个按钮的宽度占屏幕宽度的50%Button android:idid/button android:layout_width0dp !-- 在ConstraintLayout中0dp表示“匹配约束” -- android:layout_heightwrap_content app:layout_constraintStart_toStartOfparent app:layout_constraintEnd_toEndOfparent app:layout_constraintWidth_defaultpercent app:layout_constraintWidth_percent0.5 / !-- 宽度为父容器的50% --这种方式能更好地适应不同宽度的屏幕比写死一个200dp要灵活和可靠得多。5.3 建立项目的尺寸规范体系在一个中大型项目中不应该在布局文件中到处写散落的dp和sp值。应该建立一个统一的尺寸资源文件dimens.xml。!-- res/values/dimens.xml -- resources !-- 间距系统 -- dimen namespacing_tiny4dp/dimen dimen namespacing_small8dp/dimen dimen namespacing_medium16dp/dimen dimen namespacing_large24dp/dimen dimen namespacing_huge32dp/dimen !-- 字体大小系统 -- dimen nametext_size_caption12sp/dimen dimen nametext_size_body14sp/dimen dimen nametext_size_subtitle16sp/dimen dimen nametext_size_title20sp/dimen dimen nametext_size_headline24sp/dimen !-- 控件标准尺寸 -- dimen namebutton_height_standard48dp/dimen dimen nameicon_size_small24dp/dimen dimen nameicon_size_medium32dp/dimen /resources然后在布局中引用dimen/spacing_medium。这样做的好处是保持一致性整个应用的间距、字体大小有统一的视觉节奏。易于修改如果需要调整整个应用的间距尺度只需修改一个文件。便于适配可以轻松地为values-sw600dp创建另一个dimens.xml定义一套适合平板的尺寸规范。5.4 测试策略覆盖你的密度和尺寸不要只在你自己的高清手机上测试。建立一套有效的测试矩阵密度测试确保在hdpi(240dpi)、xhdpi(320dpi)、xxhdpi(480dpi) 等不同密度的模拟器或真机上运行检查图片是否清晰布局是否错乱。字体缩放测试在手机的系统设置中将字体大小从“小”调到“巨大”然后打开你的应用。检查所有文字是否可见、是否被截断、布局是否被撑坏。屏幕尺寸测试使用屏幕宽度差异巨大的设备进行测试如小屏手机sw320dp、主流手机sw360dp-400dp、大屏手机/小平板sw600dp、平板sw720dp。检查布局是否充分利用了空间还是显得过于拥挤或空旷。理解并熟练运用px、dp、sp是构建一个健壮、美观、用户体验一致的Android应用的起点。它远不止是记忆几个缩写而是建立一种与设备多样性共存的思维方式。从今天起在写每一行布局代码时都问自己一句“我这里用的单位对吗”