一、 引言：字重，Android UI 精致度的 “隱形推手”

1.1 為什么字體字重是 UI 設(shè)計(jì)的關(guān)鍵細(xì)節(jié)

在 Android 開發(fā)的廣闊天地里，每一個(gè)像素、每一抹色彩、每一處排版，都在悄無(wú)聲息地訴說(shuō)著產(chǎn)品的品質(zhì)與格調(diào)。其中，字體字重（Font Weight）這一看似微不足道的元素，實(shí)則是打造精致 UI 的秘密武器，堪稱提升界面層次感的 “隱形推手” 。

當(dāng)你打開那些廣受歡迎的 APP，是否曾留意到，它們的標(biāo)題與正文的字重差異處理得恰到好處？重要信息通過(guò)加粗的字體強(qiáng)勢(shì) “出圈”，瞬間抓住你的眼球，引導(dǎo)你的視線自然流動(dòng)，讓你在瀏覽界面時(shí)能夠迅速定位關(guān)鍵內(nèi)容。這種精準(zhǔn)的字重設(shè)置，極大地提升了信息傳達(dá)的效率，還巧妙地豐富了整個(gè)界面的視覺層次，使其更加和諧、美觀。就像為界面注入了一股靈動(dòng)的生命力，讓它從平淡無(wú)奇變得光彩照人，用戶體驗(yàn)也隨之邁向新的高度。

在這個(gè)追求極致用戶體驗(yàn)的時(shí)代，如何在 Android 應(yīng)用中實(shí)現(xiàn)字體字重的精準(zhǔn)設(shè)置，已然成為開發(fā)者們急需攻克的重要課題。

1.2 本文核心內(nèi)容速覽

接下來(lái)，我們將一同踏上這充滿驚喜的探索之旅，從 XML 的神奇配置入手，揭開一個(gè) “空文件” 改變字重的秘密；再深入到 Kotlin 的動(dòng)態(tài)世界，掌握根據(jù)業(yè)務(wù)邏輯靈活調(diào)整字重的技巧；當(dāng)然，也會(huì)為大家詳細(xì)剖析常見問(wèn)題與避坑指南，最后通過(guò)實(shí)戰(zhàn)案例展示這些技術(shù)在實(shí)際項(xiàng)目中的應(yīng)用。無(wú)論你是初出茅廬的 Android 開發(fā)新手，還是經(jīng)驗(yàn)豐富的技術(shù)達(dá)人，相信都能在本文中收獲滿滿，全面解鎖 Android 字體字重設(shè)置的奧秘。

二、 核心認(rèn)知：Font Weight 到底是什么？

2.1 Font Weight 的定義與取值范圍

在深入探討實(shí)現(xiàn)方法之前，我們先來(lái)搞清楚 Font Weight 的本質(zhì)。簡(jiǎn)單來(lái)說(shuō)，F(xiàn)ont Weight 就是字體的粗細(xì)程度，它是控制文本視覺重量感的關(guān)鍵因素。在 Android 系統(tǒng)中，字體字重的取值范圍經(jīng)歷了一個(gè)重要的變革。在 Android 9.0（API 28）之前，開發(fā)者可選擇的字體字重樣式極為有限，基本只有 normal（對(duì)應(yīng)數(shù)值 400）和 bold（對(duì)應(yīng)數(shù)值 700）這兩種，就像在狹窄的小路上行走，選擇少得可憐。

而隨著 Android 系統(tǒng)的不斷進(jìn)化，從 Android 9.0 開始，字體字重的取值范圍得到了極大的擴(kuò)展，支持從 1 到 1000 的連續(xù)數(shù)值 ，這就好比從小路一下子踏入了廣闊的大道，選擇變得豐富多彩。這種變化讓開發(fā)者能夠更加精準(zhǔn)地控制字體的顯示效果，為用戶帶來(lái)更加細(xì)膩的視覺體驗(yàn)。

在這豐富的取值范圍內(nèi)，一些常用的數(shù)值有著特定的含義和視覺效果：

• 400：代表 Normal，也就是我們?nèi)粘？吹降某Ｒ?guī)字體粗細(xì)，它就像一杯恰到好處的白開水，簡(jiǎn)潔而自然，是文本顯示的基礎(chǔ)樣式，在大量的正文內(nèi)容中廣泛應(yīng)用，讓用戶閱讀起來(lái)輕松舒適。
• 500/600：對(duì)應(yīng) Medium / Semi-Bold，屬于中等粗細(xì)或半粗體。這種字重介于常規(guī)和粗體之間，就像在白開水中加入了一點(diǎn)淡淡的果汁，增添了一絲獨(dú)特的風(fēng)味。它在需要稍微突出但又不過(guò)于張揚(yáng)的文本中表現(xiàn)出色，比如一些小標(biāo)題或者需要強(qiáng)調(diào)但又不想過(guò)于強(qiáng)勢(shì)的內(nèi)容。
• 700：表示 Bold，即粗體。粗體字就像一杯濃郁的咖啡，充滿力量感，能夠迅速吸引用戶的注意力，常用于重要的標(biāo)題、強(qiáng)調(diào)的關(guān)鍵詞等，讓關(guān)鍵信息在頁(yè)面中脫穎而出，成為用戶視線的焦點(diǎn)。

2.2 系統(tǒng)默認(rèn)字體族（Roboto）的字重支持

Android 系統(tǒng)默認(rèn)的字體族是 Roboto，這是一款專為屏幕顯示設(shè)計(jì)的現(xiàn)代無(wú)襯線字體 ，它就像一位貼心的伙伴，為我們的字體設(shè)置提供了強(qiáng)大的支持。Roboto 字體族內(nèi)置了多檔字重文件，從超細(xì)體到粗黑體，涵蓋了多種不同的粗細(xì)程度，滿足了各種設(shè)計(jì)需求。這種豐富的字重支持，為我們后面將要介紹的 “零外部字體” 方案奠定了堅(jiān)實(shí)的基礎(chǔ)。

正是因?yàn)?Roboto 字體族的存在，我們無(wú)需引入外部的.ttf 字體文件，就能在 Android 應(yīng)用中實(shí)現(xiàn)細(xì)膩的字重調(diào)整。這不僅大大簡(jiǎn)化了開發(fā)流程，還能有效減少應(yīng)用的包體積，提升應(yīng)用的性能，讓我們的應(yīng)用更加輕盈、高效地運(yùn)行。就像搭建一座房子，有了優(yōu)質(zhì)的基礎(chǔ)材料，我們就能輕松地構(gòu)建出各種精美的建筑結(jié)構(gòu)。

三、 XML 黑科技：一個(gè)空文件搞定精準(zhǔn)字重控制

3.1 神奇操作：創(chuàng)建空 font-family 配置文件

接下來(lái)，就為大家揭曉這個(gè)堪稱 “黑科技” 的 XML 字重設(shè)置方法，它的神奇之處在于，只需一個(gè)幾乎為空的文件，就能實(shí)現(xiàn)字體字重的精準(zhǔn)控制 。

首先，我們要在項(xiàng)目的 res/font 目錄下創(chuàng)建一個(gè) font-family 配置文件，不妨將它命名為 system_font.xml 。這個(gè)文件的內(nèi)容十分簡(jiǎn)潔，甚至可以用 “極簡(jiǎn)” 來(lái)形容，只需寫入如下代碼：

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:app="http://schemas.android.com/apk/res-auto">
</font-family>

你沒看錯(cuò)，就是這么簡(jiǎn)單！這個(gè)文件中甚至沒有引入任何字體資源，僅僅是一個(gè)空的 font-family 標(biāo)簽 。但千萬(wàn)別小看這個(gè)看似不起眼的空文件，它可是我們實(shí)現(xiàn)字重控制的關(guān)鍵 “法寶”，就像一把隱藏的鑰匙，即將為我們開啟精準(zhǔn)字重設(shè)置的大門。它的核心作用在于，當(dāng)我們?cè)诓季种幸眠@個(gè)文件時(shí)，會(huì)觸發(fā)系統(tǒng)的特定機(jī)制，為后續(xù)的字重設(shè)置奠定基礎(chǔ)，就像為一場(chǎng)精彩的演出搭建好了舞臺(tái)。

3.2 布局中應(yīng)用：兩行代碼實(shí)現(xiàn)字重定制

創(chuàng)建好這個(gè)神奇的空文件后，我們就可以在布局文件中大展身手了。以 TextView 為例，在布局文件中添加如下代碼：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:fontFamily="@font/system_font"
    android:textFontWeight="600"
    android:text="精準(zhǔn)控制字重" />

在上述代碼中，通過(guò) android:fontFamily 屬性引用了剛剛創(chuàng)建的 system_font.xml 文件 ，就如同將鑰匙插入了鎖孔；同時(shí)，使用 android:textFontWeight 屬性將字重設(shè)置為 600 ，這就像是轉(zhuǎn)動(dòng)鑰匙，啟動(dòng)了精準(zhǔn)字重控制的 “開關(guān)”。運(yùn)行應(yīng)用后，你會(huì)驚喜地發(fā)現(xiàn)，TextView 中的文字字重成功變?yōu)榱宋覀冊(cè)O(shè)定的數(shù)值，輕松實(shí)現(xiàn)了精準(zhǔn)的字重控制 。

與傳統(tǒng)的字重設(shè)置方案相比，這種方法的優(yōu)勢(shì)顯而易見。傳統(tǒng)方案往往需要引入外部的.ttf 字體文件，這不僅增加了應(yīng)用的包體積，還可能涉及版權(quán)問(wèn)題，就像給應(yīng)用加上了沉重的負(fù)擔(dān)。而我們的 “空文件” 方案，無(wú)需引入任何外部字體，包體積為零，而且操作簡(jiǎn)單便捷，只需要兩行代碼就能完成字重定制，大大提高了開發(fā)效率，讓應(yīng)用更加輕盈、高效地運(yùn)行。

3.3 原理揭秘：Font Fallback（回退）機(jī)制

這個(gè)看似神奇的 “空文件魔法” 背后，其實(shí)蘊(yùn)含著深刻的原理。當(dāng)我們?cè)诓季种惺褂?android:fontFamily 屬性引用一個(gè) font-family 資源時(shí)，系統(tǒng)會(huì)根據(jù)這個(gè)資源來(lái)尋找對(duì)應(yīng)的字體 。而當(dāng) font-family 文件為空時(shí)，系統(tǒng)會(huì)默認(rèn)指向其內(nèi)置的默認(rèn)字體族，在大多數(shù) Android 系統(tǒng)中，這個(gè)默認(rèn)字體族就是 Roboto 。

同時(shí)，由于我們?cè)O(shè)置了 android:textFontWeight 屬性，系統(tǒng)會(huì)觸發(fā) Font Fallback（回退）機(jī)制 。該機(jī)制會(huì)在默認(rèn)字體族（即 Roboto 字體族）中搜索與我們?cè)O(shè)定的字重值（如這里的 600 ）最接近的字重文件 。因?yàn)?Roboto 字體族內(nèi)置了多檔字重文件，系統(tǒng)能夠從中找到合適的字重進(jìn)行匹配。找到匹配的字重文件后，系統(tǒng)就會(huì)使用這個(gè)文件來(lái)渲染文本，從而實(shí)現(xiàn)了通過(guò)一個(gè)空文件和簡(jiǎn)單的屬性設(shè)置來(lái)控制字體字重的效果 。

這一機(jī)制充分利用了系統(tǒng)的默認(rèn)資源，既減少了開發(fā)的工作量，又避免了引入外部字體文件帶來(lái)的包體積增加問(wèn)題，是一種非常巧妙且高效的實(shí)現(xiàn)方式 。它就像一位聰明的管家，巧妙地利用現(xiàn)有的資源，為我們打造出理想的字體顯示效果，讓我們?cè)诓辉黾宇~外負(fù)擔(dān)的情況下，輕松實(shí)現(xiàn)了字體字重的精準(zhǔn)控制。

四、 Kotlin 進(jìn)階：動(dòng)態(tài)字重，適配業(yè)務(wù)場(chǎng)景變化

在實(shí)際開發(fā)中，靜態(tài)的字體字重往往難以滿足復(fù)雜多變的業(yè)務(wù)需求。比如，在一個(gè)電商 APP 中，當(dāng)用戶進(jìn)行商品搜索時(shí)，搜索結(jié)果中的關(guān)鍵詞需要突出顯示，這就要求我們能夠根據(jù)搜索關(guān)鍵詞動(dòng)態(tài)調(diào)整字體的字重，讓關(guān)鍵信息一目了然；又或者在一個(gè)支持夜間模式的閱讀類 APP 中，隨著主題的切換，字體的字重也需要相應(yīng)地改變，以適配不同的視覺環(huán)境，為用戶提供舒適的閱讀體驗(yàn) 。這時(shí)候，Kotlin 的動(dòng)態(tài)字重設(shè)置就顯得尤為重要，它就像一把萬(wàn)能 鑰匙，能夠打開各種復(fù)雜業(yè)務(wù)場(chǎng)景的大門。

4.1 API 28 + 精準(zhǔn)控制：Typeface.create 專屬方案

對(duì)于 Android 9.0（API 28）及以上版本的設(shè)備，Kotlin 提供了強(qiáng)大的 Typeface.create 方法，讓我們能夠?qū)崿F(xiàn)對(duì)字體字重的精準(zhǔn)控制 。通過(guò)這個(gè)方法，我們可以根據(jù)業(yè)務(wù)需求動(dòng)態(tài)地創(chuàng)建具有指定字重的 Typeface 對(duì)象，然后將其應(yīng)用到 TextView 等控件上，從而實(shí)現(xiàn)字重的靈活調(diào)整 。

為了方便使用，我們可以將這個(gè)功能封裝成一個(gè)擴(kuò)展函數(shù)。在 Kotlin 中，擴(kuò)展函數(shù)就像是給已有的類添加新的方法，而不需要修改原始類的代碼，非常便捷。下面是具體的代碼實(shí)現(xiàn)：

import android.os.Build
import android.widget.TextView
import android.graphics.Typeface
fun TextView.setFontWeight(weight: Int) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        // Typeface.create(Typeface, Weight, isItalic)
        this.typeface = Typeface.create(this.typeface, weight, false)
    }
}

在這段代碼中，首先通過(guò) Build.VERSION.SDK_INT 判斷當(dāng)前設(shè)備的系統(tǒng)版本是否大于等于 Android 9.0（API 28） 。如果滿足條件，就調(diào)用 Typeface.create 方法創(chuàng)建一個(gè)新的 Typeface 對(duì)象 。這個(gè)方法接收三個(gè)參數(shù)：第一個(gè)參數(shù)是當(dāng)前 TextView 的原有 Typeface ，它就像一個(gè)基礎(chǔ)模板，為新的 Typeface 提供了原始的字體樣式；第二個(gè)參數(shù) weight 是我們要設(shè)置的字重值，它決定了新字體的粗細(xì)程度；第三個(gè)參數(shù) false 表示不設(shè)置為斜體 ，保持字體的正常樣式。最后，將創(chuàng)建好的新 Typeface 對(duì)象應(yīng)用到 TextView 上，完成字重的精準(zhǔn)設(shè)置 。

這種方案的優(yōu)勢(shì)十分明顯，它支持從 1 到 1000 的全范圍字重?cái)?shù)值 ，就像一個(gè)精細(xì)的調(diào)節(jié)器，能夠滿足各種精細(xì)化的設(shè)計(jì)需求。無(wú)論是需要極細(xì)的字體來(lái)營(yíng)造優(yōu)雅的氛圍，還是需要極粗的字體來(lái)突出重要信息，它都能輕松應(yīng)對(duì)，為用戶帶來(lái)更加豐富、細(xì)膩的視覺體驗(yàn) 。

4.2 全版本兼容：高低版本無(wú)縫適配擴(kuò)展函數(shù)

雖然 API 28 + 的精準(zhǔn)控制方案非常強(qiáng)大，但考慮到 Android 設(shè)備的碎片化問(wèn)題，仍有大量舊版本設(shè)備在使用 。為了確保應(yīng)用在所有設(shè)備上都能正常運(yùn)行，并且實(shí)現(xiàn)字重的有效設(shè)置，我們需要編寫一個(gè)兼容性擴(kuò)展函數(shù)，讓不同版本的設(shè)備都能享受到動(dòng)態(tài)字重的功能 。

下面是實(shí)現(xiàn)全版本兼容的擴(kuò)展函數(shù)代碼：

import android.os.Build
import android.widget.TextView
import android.graphics.Typeface
fun TextView.setSmartFontWeight(weight: Int) {
    when {
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.P -> {
            // API 28+ 精準(zhǔn)設(shè)置
            this.typeface = Typeface.create(this.typeface, weight, false)
        }
        weight >= 500 -> {
            // 低版本回退到系統(tǒng)預(yù)設(shè)的中等粗細(xì)
            this.typeface = Typeface.create("sans-serif-medium", Typeface.NORMAL)
        }
        else -> {
            // 默認(rèn)使用系統(tǒng)默認(rèn)字體
            this.typeface = Typeface.DEFAULT
        }
    }
}

在這個(gè)函數(shù)中，使用了 when 表達(dá)式進(jìn)行條件判斷 。首先判斷當(dāng)前設(shè)備的系統(tǒng)版本是否大于等于 Android 9.0（API 28） 。如果是，就采用前面介紹的精準(zhǔn)控制方案，通過(guò) Typeface.create 方法設(shè)置指定的字重值 。如果系統(tǒng)版本低于 API 28 ，則進(jìn)一步判斷要設(shè)置的字重值 weight 。當(dāng) weight 大于等于 500 時(shí)，將字體設(shè)置為系統(tǒng)預(yù)設(shè)的中等粗細(xì)字體 “sans-serif-medium” ，這是一種在低版本設(shè)備上比較接近 Medium 字重的替代方案；如果 weight 小于 500 ，則直接使用系統(tǒng)默認(rèn)字體 Typeface.DEFAULT ，保證文本在各種情況下都能以合適的字體顯示 。

通過(guò)這種方式，我們成功實(shí)現(xiàn)了全版本兼容的動(dòng)態(tài)字重設(shè)置 ，解決了舊設(shè)備上字重設(shè)置無(wú)效的問(wèn)題，確保應(yīng)用在不同版本的 Android 設(shè)備上都能穩(wěn)定運(yùn)行，為用戶提供一致的體驗(yàn) 。

4.3 工具類封裝：提升代碼復(fù)用性

為了進(jìn)一步提升代碼的復(fù)用性和可維護(hù)性，我們可以將上述擴(kuò)展函數(shù)封裝成一個(gè)獨(dú)立的工具類 。工具類就像是一個(gè)百寶箱，把常用的功能函數(shù)都收納其中，方便在項(xiàng)目的各個(gè)角落調(diào)用 。

創(chuàng)建一個(gè)名為 FontUtils 的工具類，代碼如下：

import android.os.Build
import android.widget.TextView
import android.graphics.Typeface
object FontUtils {
    fun TextView.setFontWeight(weight: Int) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            this.typeface = Typeface.create(this.typeface, weight, false)
        }
    }
    fun TextView.setSmartFontWeight(weight: Int) {
        when {
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.P -> {
                this.typeface = Typeface.create(this.typeface, weight, false)
            }
            weight >= 500 -> {
                this.typeface = Typeface.create("sans-serif-medium", Typeface.NORMAL)
            }
            else -> {
                this.typeface = Typeface.DEFAULT
            }
        }
    }
}

在這個(gè)工具類中，包含了前面編寫的兩個(gè)擴(kuò)展函數(shù) 。在項(xiàng)目的其他地方，只需要通過(guò) FontUtils 類來(lái)調(diào)用這些函數(shù)，就可以輕松實(shí)現(xiàn)字體字重的設(shè)置 。比如，在某個(gè) Activity 中，想要設(shè)置一個(gè) TextView 的字重為 600 ，可以這樣調(diào)用：

val textView: TextView = findViewById(R.id.text_view)
FontUtils.setSmartFontWeight(600)

這樣，不僅代碼更加簡(jiǎn)潔明了，還減少了重復(fù)代碼的編寫，提高了開發(fā)效率 。同時(shí)，將相關(guān)功能封裝在工具類中，也符合 Android 開發(fā)的工程化規(guī)范，讓項(xiàng)目的結(jié)構(gòu)更加清晰，易于維護(hù)和擴(kuò)展 。就像把各種工具整齊地?cái)[放在工具箱里，需要的時(shí)候隨時(shí)取用，讓開發(fā)工作更加高效、有序 。

五、 避坑指南：這些 “坑” 90% 的開發(fā)者都踩過(guò)

在實(shí)際開發(fā)過(guò)程中，字體字重設(shè)置并非一帆風(fēng)順，常常會(huì)遇到各種棘手的問(wèn)題。下面，就為大家盤點(diǎn)一些常見的 “坑”，以及對(duì)應(yīng)的解決方案 。

5.1 版本兼容性陷阱：textFontWeight 的生效邊界

android:textFontWeight 屬性是實(shí)現(xiàn)字體字重精準(zhǔn)控制的重要手段，但它存在一個(gè)容易被忽視的版本兼容性問(wèn)題 。這個(gè)屬性僅在 Android 9.0（API 28）及以上版本中才會(huì)生效 ，如果在低版本設(shè)備上使用，系統(tǒng)會(huì)直接忽略該屬性，導(dǎo)致字重設(shè)置無(wú)法生效 。

想象一下，你精心設(shè)計(jì)了應(yīng)用的界面，通過(guò) android:textFontWeight 屬性為不同的文本設(shè)置了恰到好處的字重，在高版本設(shè)備上運(yùn)行時(shí)，界面效果美輪美奐，層次分明。然而，當(dāng)你將應(yīng)用部署到低版本設(shè)備上時(shí)，卻發(fā)現(xiàn)所有的字重設(shè)置都 “消失” 了，界面變得平淡無(wú)奇，這無(wú)疑會(huì)給用戶帶來(lái)極差的體驗(yàn) 。

為了規(guī)避這個(gè)問(wèn)題，在低版本設(shè)備上，我們可以優(yōu)先使用 android:fontFamily="sans-serif-medium" 等系統(tǒng)預(yù)設(shè)的字體別名來(lái)實(shí)現(xiàn)中等粗細(xì)的效果 。這些別名在低版本設(shè)備上也能正常工作，雖然無(wú)法像 android:textFontWeight 屬性那樣實(shí)現(xiàn)精準(zhǔn)的數(shù)值控制，但能在一定程度上滿足基本的字重需求 。例如：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:fontFamily="sans-serif-medium"
    android:text="低版本設(shè)備適用的中等粗細(xì)字體" />

通過(guò)這種方式，我們可以確保應(yīng)用在不同版本的設(shè)備上都能保持相對(duì)一致的字重顯示效果，提升用戶體驗(yàn) 。

5.2 廠商定制坑：國(guó)產(chǎn)手機(jī)字體庫(kù)精簡(jiǎn)問(wèn)題

部分國(guó)產(chǎn)手機(jī)廠商為了優(yōu)化系統(tǒng)性能、減少系統(tǒng)占用空間，對(duì)內(nèi)置的字體庫(kù)進(jìn)行了精簡(jiǎn) 。這一優(yōu)化措施雖然在一定程度上提升了系統(tǒng)的運(yùn)行效率，但卻給字體字重設(shè)置帶來(lái)了新的問(wèn)題 。在這些經(jīng)過(guò)精簡(jiǎn)的字體庫(kù)中，可能只保留了 Regular（對(duì)應(yīng)字重 400 ）和 Bold（對(duì)應(yīng)字重 700 ）兩種物理文件 ，而對(duì)于 500、600 等中檔位的字重，雖然在代碼中進(jìn)行了設(shè)置，但由于字體庫(kù)中缺乏對(duì)應(yīng)的文件，最終顯示效果可能與 400 或 700 并無(wú)差異 。

例如，你在應(yīng)用中為某個(gè)小標(biāo)題設(shè)置了字重為 500 ，期望它能以中等粗細(xì)的字體顯示，從而與正文形成區(qū)分，突出重點(diǎn)。但在某些國(guó)產(chǎn)手機(jī)上運(yùn)行時(shí)，你會(huì)驚訝地發(fā)現(xiàn)，小標(biāo)題的字體粗細(xì)與正文完全一樣，沒有達(dá)到預(yù)期的效果 。這就是因?yàn)檫@些手機(jī)的字體庫(kù)中沒有 500 字重對(duì)應(yīng)的文件，系統(tǒng)無(wú)法正確渲染 。

為了避免這種情況的發(fā)生，當(dāng)遇到字體庫(kù)精簡(jiǎn)問(wèn)題時(shí)，我們可以優(yōu)先選用系統(tǒng)明確支持的字重?cái)?shù)值 。比如，對(duì)于需要中等粗細(xì)字體的場(chǎng)景，在低版本設(shè)備上可以使用前面提到的 android:fontFamily="sans-serif-medium" ；在高版本設(shè)備上，如果擔(dān)心字體庫(kù)精簡(jiǎn)問(wèn)題，也可以直接使用系統(tǒng)默認(rèn)支持且有明確物理文件對(duì)應(yīng)的字重，如 400 和 700 。另外，我們還可以提供備選字體方案 ，即當(dāng)檢測(cè)到當(dāng)前設(shè)備存在字體庫(kù)精簡(jiǎn)問(wèn)題時(shí)，動(dòng)態(tài)切換到其他支持全字重的字體庫(kù)，確保字重設(shè)置能夠正確生效 。

5.3 空 XML 健壯性優(yōu)化：避免系統(tǒng)兼容風(fēng)險(xiǎn)

在前面介紹的 XML 黑科技中，我們利用了一個(gè)幾乎為空的 font-family 文件來(lái)實(shí)現(xiàn)字重控制 。雖然這種方法在新系統(tǒng)上運(yùn)行良好，但從代碼健壯性和長(zhǎng)期維護(hù)的角度來(lái)看，存在一定的潛在風(fēng)險(xiǎn) 。如果系統(tǒng)在未來(lái)的版本更新中對(duì)空 font-family 文件的處理機(jī)制發(fā)生變化，或者不同廠商的系統(tǒng)對(duì)空文件的解析存在差異，都可能導(dǎo)致字重設(shè)置出現(xiàn)異常 。

為了提升代碼的穩(wěn)定性和可維護(hù)性，建議在 font-family 文件中顯式地指向 @android:font/sans_serif ，即系統(tǒng)默認(rèn)的無(wú)襯線字體族 。這樣，即使系統(tǒng)發(fā)生變化，也能保證我們的字重設(shè)置基于一個(gè)穩(wěn)定的默認(rèn)字體族進(jìn)行 。修改后的 system_font.xml 文件內(nèi)容如下：

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:app="http://schemas.android.com/apk/res-auto">
    <font
        app:fontStyle="normal"
        app:fontWeight="400"
        app:font="@android:font/sans_serif" />
</font-family>

通過(guò)這種方式，我們固定了默認(rèn)字體族，避免了因空文件可能帶來(lái)的系統(tǒng)兼容風(fēng)險(xiǎn) ，讓我們的代碼更加健壯，能夠在各種復(fù)雜的系統(tǒng)環(huán)境中穩(wěn)定運(yùn)行 。

六、 實(shí)戰(zhàn)場(chǎng)景：字重設(shè)置的真實(shí)應(yīng)用案例

6.1 搜索結(jié)果高亮：動(dòng)態(tài)調(diào)整關(guān)鍵詞字重

在實(shí)際的應(yīng)用開發(fā)中，搜索功能是一個(gè)非常常見且重要的功能。以一個(gè)資訊類 APP 為例，當(dāng)用戶在搜索框中輸入關(guān)鍵詞后，搜索結(jié)果頁(yè)面需要將關(guān)鍵詞突出顯示，以便用戶能夠快速定位到關(guān)鍵信息 。這時(shí)候，我們就可以利用前面介紹的 Kotlin 動(dòng)態(tài)字重設(shè)置技術(shù)來(lái)實(shí)現(xiàn)這一效果 。

假設(shè)我們已經(jīng)獲取到了搜索結(jié)果的文本內(nèi)容以及用戶輸入的關(guān)鍵詞 ，通過(guò)編寫一個(gè) Kotlin 擴(kuò)展函數(shù)，我們可以輕松地實(shí)現(xiàn)關(guān)鍵詞字重的動(dòng)態(tài)調(diào)整 。以下是實(shí)現(xiàn)這一功能的關(guān)鍵代碼：

fun TextView.highlightSearchResult(keyword: String) {
    val text = this.text.toString()
    val startIndex = text.indexOf(keyword)
    if (startIndex != -1) {
        val spannableString = SpannableString(text)
        spannableString.setSpan(
            object : StyleSpan(Typeface.BOLD) {
                override fun updateDrawState(ds: TextPaint) {
                    super.updateDrawState(ds)
                    ds.fontWeight = 600.toFloat()
                }
            },
            startIndex,
            startIndex + keyword.length,
            Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
        )
        this.text = spannableString
    }
}

在這段代碼中，首先通過(guò)indexOf方法查找關(guān)鍵詞在文本中的起始位置 。如果找到了關(guān)鍵詞，就創(chuàng)建一個(gè)SpannableString對(duì)象，然后使用setSpan方法為關(guān)鍵詞設(shè)置一個(gè)自定義的StyleSpan 。在這個(gè)StyleSpan中，重寫了updateDrawState方法，將關(guān)鍵詞的字重設(shè)置為 600 ，而文本的其他部分則保持默認(rèn)的字重（通常為 400 ） 。最后，將設(shè)置好字重的SpannableString應(yīng)用到 TextView 上，實(shí)現(xiàn)了搜索結(jié)果中關(guān)鍵詞的高亮顯示 。通過(guò)這種方式，用戶在查看搜索結(jié)果時(shí)，能夠一目了然地看到關(guān)鍵詞，大大提升了信息的辨識(shí)度和用戶的閱讀體驗(yàn) 。

6.2 動(dòng)態(tài)主題切換：跟隨主題調(diào)整字重風(fēng)格

在支持動(dòng)態(tài)主題切換的應(yīng)用中，字體字重的調(diào)整也是一個(gè)關(guān)鍵的環(huán)節(jié) 。以一款閱讀類 APP 為例，用戶可以在白天模式和夜間模式之間自由切換 。在白天模式下，界面通常采用明亮的背景和相對(duì)較細(xì)的字體，以提供清晰、舒適的閱讀體驗(yàn)；而在夜間模式下，為了適應(yīng)較暗的環(huán)境，同時(shí)突出重要信息，字體字重可能需要適當(dāng)增加，以增強(qiáng)文字與背景的對(duì)比度 。

為了實(shí)現(xiàn)這一功能，我們可以在主題切換的邏輯中，利用 Kotlin 動(dòng)態(tài)修改標(biāo)題、正文等不同文本元素的字重?cái)?shù)值 。假設(shè)我們已經(jīng)定義了白天模式和夜間模式的主題資源，并且在 Activity 中實(shí)現(xiàn)了主題切換的方法，以下是在主題切換時(shí)動(dòng)態(tài)調(diào)整字重的代碼示例：

class MainActivity : AppCompatActivity() {
    private val titleTextView: TextView by lazy { findViewById(R.id.title_text_view) }
    private val contentTextView: TextView by lazy { findViewById(R.id.content_text_view) }
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // 初始化主題
        applyTheme()
        // 模擬主題切換按鈕點(diǎn)擊事件
        val switchThemeButton: Button = findViewById(R.id.switch_theme_button)
        switchThemeButton.setOnClickListener {
            // 切換主題
            if (isDarkTheme) {
                setTheme(R.style.LightTheme)
                isDarkTheme = false
            } else {
                setTheme(R.style.DarkTheme)
                isDarkTheme = true
            }
            // 重新應(yīng)用主題
            applyTheme()
            // 重建Activity以應(yīng)用新主題
            recreate()
        }
    }
    private var isDarkTheme = false
    private fun applyTheme() {
        if (isDarkTheme) {
            // 夜間主題，增加字重
            FontUtils.setSmartFontWeight(titleTextView, 700)
            FontUtils.setSmartFontWeight(contentTextView, 500)
        } else {
            // 白天主題，恢復(fù)正常字重
            FontUtils.setSmartFontWeight(titleTextView, 400)
            FontUtils.setSmartFontWeight(contentTextView, 400)
        }
    }
}

在這段代碼中，首先在onCreate方法中初始化主題，并為主題切換按鈕設(shè)置點(diǎn)擊事件 。當(dāng)按鈕被點(diǎn)擊時(shí)，根據(jù)當(dāng)前的主題狀態(tài)切換到相反的主題，并調(diào)用applyTheme方法重新應(yīng)用主題 。在applyTheme方法中，根據(jù)主題的不同，使用前面封裝的FontUtils工具類動(dòng)態(tài)調(diào)整標(biāo)題和正文的字重 。這樣，當(dāng)用戶切換主題時(shí)，字體字重也會(huì)相應(yīng)地改變，使得界面在不同主題下都能保持良好的視覺效果和閱讀體驗(yàn) ，實(shí)現(xiàn)了界面風(fēng)格的統(tǒng)一協(xié)調(diào) 。

七、 總結(jié)：按需選型，零成本提升 UI 質(zhì)感

7.1 不同需求的方案選型指南

在 Android 開發(fā)的旅程中，我們探索了多種字體字重設(shè)置方案，每一種都有其獨(dú)特的優(yōu)勢(shì)和適用場(chǎng)景 。

如果你追求極簡(jiǎn)開發(fā)，希望用最少的代碼和資源實(shí)現(xiàn)精準(zhǔn)字重控制，那么空 XML+textFontWeight 方案無(wú)疑是你的最佳選擇 。它操作簡(jiǎn)單，只需要一個(gè)空的 font-family 文件和兩行布局代碼，就能輕松實(shí)現(xiàn)字重的定制 。而且，這種方案充分利用了系統(tǒng)的默認(rèn)字體資源，無(wú)需引入外部字體，包體積為零，讓你的應(yīng)用更加輕盈、高效 。

如果你更注重兼容性，希望應(yīng)用在各種版本的 Android 設(shè)備上都能穩(wěn)定運(yùn)行，并且實(shí)現(xiàn)基本的字重設(shè)置，那么系統(tǒng)字體別名方案是你的可靠伙伴 。通過(guò)使用 android:fontFamily="sans-serif-medium" 等系統(tǒng)預(yù)設(shè)的字體別名，你可以在低版本設(shè)備上實(shí)現(xiàn)中等粗細(xì)的字體效果 。雖然這種方案無(wú)法像 textFontWeight 屬性那樣實(shí)現(xiàn)精準(zhǔn)的數(shù)值控制，但它在低版本設(shè)備上的兼容性非常好，能夠確保應(yīng)用在不同設(shè)備上都能保持相對(duì)一致的字重顯示效果 。

而如果你需要根據(jù)業(yè)務(wù)邏輯動(dòng)態(tài)調(diào)整字體字重，實(shí)現(xiàn)更加靈活、個(gè)性化的 UI 效果，那么 Kotlin 擴(kuò)展函數(shù)方案則能滿足你的需求 。通過(guò)編寫 Kotlin 擴(kuò)展函數(shù)，你可以在代碼中根據(jù)各種條件動(dòng)態(tài)創(chuàng)建具有指定字重的 Typeface 對(duì)象，并將其應(yīng)用到 TextView 等控件上 。這種方案不僅支持從 1 到 1000 的全范圍字重?cái)?shù)值，還能通過(guò)工具類封裝提升代碼的復(fù)用性和可維護(hù)性 。同時(shí)，我們還提供了全版本兼容的擴(kuò)展函數(shù)，確保應(yīng)用在不同版本的設(shè)備上都能正常運(yùn)行 。

無(wú)論你選擇哪種方案，都能在不引入外部字體的情況下，實(shí)現(xiàn)零體積成本的 UI 優(yōu)化 。這不僅有助于提升應(yīng)用的性能，還能為用戶帶來(lái)更加精致、流暢的視覺體驗(yàn) 。

7.2 進(jìn)階前瞻：可變字體（Variable Fonts）的未來(lái)

在字體技術(shù)的不斷演進(jìn)中，可變字體（Variable Fonts）正逐漸嶄露頭角，成為未來(lái)字體發(fā)展的重要方向 。可變字體是一種基于 OpenType 標(biāo)準(zhǔn)的新型字體技術(shù)，它允許通過(guò)單一字體文件實(shí)現(xiàn)多軸（如字重、寬度、傾斜度等）的動(dòng)態(tài)調(diào)整 。與傳統(tǒng)的靜態(tài)字體相比，可變字體具有諸多優(yōu)勢(shì) 。

可變字體最大的亮點(diǎn)在于，它可以將多個(gè)字體樣式（如不同字重、字寬、傾斜度等）整合在一個(gè)單一的、高度靈活的文件中 。這意味著，開發(fā)者無(wú)需為不同的字重或樣式引入多個(gè)字體文件，大大減少了字體文件的數(shù)量和體積 。例如，在傳統(tǒng)的字體使用中，我們可能需要為常規(guī)、加粗、斜體等不同樣式分別引入對(duì)應(yīng)的字體文件，而可變字體則可以通過(guò)一個(gè)文件實(shí)現(xiàn)所有這些樣式的動(dòng)態(tài)切換 。這種特性不僅減少了應(yīng)用的包體積，還能加快字體的加載速度，提升應(yīng)用的性能 。

可變字體支持通過(guò) CSS 或相關(guān) API 對(duì)字體的可變軸進(jìn)行動(dòng)態(tài)控制 。開發(fā)者可以根據(jù)用戶的操作、設(shè)備的狀態(tài)或業(yè)務(wù)邏輯，實(shí)時(shí)調(diào)整字體的字重、寬度、傾斜度等參數(shù)，實(shí)現(xiàn)更加豐富、個(gè)性化的排版效果 。比如，在一個(gè)支持手勢(shì)交互的應(yīng)用中，當(dāng)用戶縮放界面時(shí)，字體的字重和寬度可以隨之動(dòng)態(tài)變化，以適應(yīng)不同的顯示尺寸和用戶需求；或者在一個(gè)具有動(dòng)態(tài)主題切換功能的應(yīng)用中，字體的樣式可以隨著主題的變化而實(shí)時(shí)調(diào)整，為用戶帶來(lái)更加連貫、一致的視覺體驗(yàn) 。

雖然目前可變字體在 Android 開發(fā)中的應(yīng)用還相對(duì)較少，但隨著技術(shù)的不斷發(fā)展和設(shè)備的逐漸普及，相信在不久的將來(lái)，可變字體將成為 Android 開發(fā)中不可或缺的一部分 。如果你對(duì)可變字體感興趣，可以進(jìn)一步學(xué)習(xí)相關(guān)的技術(shù)文檔和案例，探索如何在 Android 應(yīng)用中引入和使用可變字體，為用戶帶來(lái)更加創(chuàng)新、優(yōu)質(zhì)的體驗(yàn) 。

八、 文末福利：可直接復(fù)制的工具類代碼

為了讓大家能夠更方便地將這些技術(shù)應(yīng)用到實(shí)際項(xiàng)目中，我特意將前面介紹的 Kotlin 擴(kuò)展函數(shù)整理成了一個(gè)完整的工具類代碼 。你可以直接復(fù)制這段代碼到你的項(xiàng)目中，根據(jù)需要調(diào)用相應(yīng)的方法，輕松實(shí)現(xiàn)字體字重的設(shè)置 。

import android.os.Build
import android.widget.TextView
import android.graphics.Typeface
object FontUtils {
    /**
     * 精準(zhǔn)設(shè)置字重，僅適用于Android 9.0（API 28）及以上版本
     * @param weight 要設(shè)置的字重值，取值范圍1 - 1000
     */
    fun TextView.setFontWeight(weight: Int) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            this.typeface = Typeface.create(this.typeface, weight, false)
        }
    }
    /**
     * 全版本兼容的字重設(shè)置方法
     * @param weight 要設(shè)置的字重值，取值范圍1 - 1000
     */
    fun TextView.setSmartFontWeight(weight: Int) {
        when {
            Build.VERSION.SDK_INT >= Build.VERSION_CODES.P -> {
                // API 28+ 精準(zhǔn)設(shè)置
                this.typeface = Typeface.create(this.typeface, weight, false)
            }
            weight >= 500 -> {
                // 低版本回退到系統(tǒng)預(yù)設(shè)的中等粗細(xì)
                this.typeface = Typeface.create("sans-serif-medium", Typeface.NORMAL)
            }
            else -> {
                // 默認(rèn)使用系統(tǒng)默認(rèn)字體
                this.typeface = Typeface.DEFAULT
            }
        }
    }
}

希望這個(gè)工具類能成為你 Android 開發(fā)之旅中的得力助手，讓你在字體字重設(shè)置的道路上一帆風(fēng)順 ！

以上就是Android字體字重設(shè)置全攻略的詳細(xì)內(nèi)容，更多關(guān)于Android字體字重設(shè)置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論