1. 從一次滑動卡頓說起ListView 到底是什么、能做什么、適合誰如果你剛開始接觸 Android或者已經(jīng)寫過幾個頁面但列表一滑就掉幀那 ListView 大概率是你繞不開的第一個“性能課”。它是一個以垂直滾動列表形式展示數(shù)據(jù)的控件能根據(jù)數(shù)據(jù)條數(shù)自適應(yīng)顯示內(nèi)容早期幾乎所有的聯(lián)系人、設(shè)置項、消息流都用它實現(xiàn)。雖然現(xiàn)在官方更推薦 RecyclerView但大量存量項目、教學(xué)示例、老版本兼容場景里 ListView 依然活躍而且它把“數(shù)據(jù)怎么變成一行行 View”這件事暴露得非常直白特別適合用來理解 Adapter 模式、ViewHolder 復(fù)用和事件分發(fā)。我見過太多初學(xué)者把數(shù)據(jù)一股腦塞進(jìn)getView()里每次滑動都重新inflate布局、重新findViewById結(jié)果列表一長就卡成幻燈片。這篇就按“能直接跑起來”的標(biāo)準(zhǔn)把 ListView 的三個核心元素——ListView 本身、Adapter 適配器、數(shù)據(jù)源——拆開講清楚再給出 Java 和 Kotlin 兩套可復(fù)制代碼最后用真實報錯帶你排查滑動卡頓。適合誰適合剛學(xué)完 Activity 想練手列表的初學(xué)者也適合想回頭補(bǔ)一補(bǔ)復(fù)用機(jī)制原理的進(jìn)階開發(fā)者。核心檢索詞先記住Android ListView 的 Adapter 綁定與 ViewHolder 復(fù)用機(jī)制。理解了這個你再看 RecyclerView 會輕松很多因為后者的思路幾乎是從這里演化出去的。2. 前置準(zhǔn)備Adapter 三種類型怎么選以及一個順手的調(diào)試入口ListView 的顯示離不開三個元素ListView 負(fù)責(zé)展示Adapter 負(fù)責(zé)把數(shù)據(jù)映射成 View數(shù)據(jù)源則是具體的字符串、圖片或?qū)ο蠹?。按適配器類型分常見的有 ArrayAdapter、SimpleAdapter 和 SimpleCursorAdapter。ArrayAdapter 最簡單只能展示一行文字SimpleAdapter 擴(kuò)展性最好可以自定義圖片、按鈕、復(fù)選框SimpleCursorAdapter 則是 SimpleAdapter 和數(shù)據(jù)庫 Cursor 的結(jié)合方便把查詢結(jié)果直接鋪到列表上。選型其實有個很實用的判斷純文本列表用 ArrayAdapter圖文混排用 SimpleAdapter數(shù)據(jù)來自 ContentProvider 或數(shù)據(jù)庫查詢用 SimpleCursorAdapter。但只要你需要在行內(nèi)放可點擊按鈕、或者要精細(xì)控制復(fù)用就必須繼承 BaseAdapter 自己寫。在動手寫代碼前我習(xí)慣先確認(rèn)一下手頭的模型調(diào)用鏈路是否正常避免把環(huán)境問題和代碼問題混在一起排查。如果你也在用大模型輔助生成或潤色 Android 代碼片段可以先用 TaoToken 模型對話 快速驗證一段 Adapter 代碼的邏輯確認(rèn)沒問題再貼進(jìn)工程里。它的接入文檔在 TaoToken 接入文檔API 入口統(tǒng)一是https://taotoken.net/api不需要額外配置復(fù)雜環(huán)境。這里要提醒一句模型對話適合驗證“這段 getView 寫得對不對”但不要讓它直接連你的生產(chǎn)數(shù)據(jù)庫或真實設(shè)備代碼最終還是要落到本地工程里跑一遍。前置準(zhǔn)備做到位后面配置和排障才不會手忙腳亂。3. 可復(fù)制配置從 ArrayAdapter 到自定義 BaseAdapter 的完整代碼先看最簡單的 ArrayAdapter。新建一個 Activity直接用系統(tǒng)布局android.R.layout.simple_list_item_1它只顯示一行文字public class MyListView extends Activity { private ListView listView; Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); listView new ListView(this); listView.setAdapter(new ArrayAdapterString( this, android.R.layout.simple_list_item_1, getData())); setContentView(listView); } private ListString getData() { ListString data new ArrayList(); data.add(測試數(shù)據(jù)1); data.add(測試數(shù)據(jù)2); data.add(測試數(shù)據(jù)3); data.add(測試數(shù)據(jù)4); return data; } }ArrayAdapter 的構(gòu)造需要三個參數(shù)Context、行布局文件、數(shù)據(jù)源 List。注意這里的布局文件描述的是“每一行”的樣子不是整個頁面。setAdapter()完成最后綁定。接下來是圖文混排的 SimpleAdapter。先定義行布局vlist.xml?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:orientationhorizontal android:layout_widthmatch_parent android:layout_heightmatch_parent ImageView android:idid/img android:layout_widthwrap_content android:layout_heightwrap_content android:layout_margin5dp / LinearLayout android:orientationvertical android:layout_widthwrap_content android:layout_heightwrap_content TextView android:idid/title android:layout_widthwrap_content android:layout_heightwrap_content android:textColor#FFFFFFFF android:textSize22sp / TextView android:idid/info android:layout_widthwrap_content android:layout_heightwrap_content android:textColor#FFFFFFFF android:textSize13sp / /LinearLayout /LinearLayout對應(yīng)代碼用ListMapString, Object作為數(shù)據(jù)源每個 Map 對應(yīng)一行public class MyListView3 extends ListActivity { Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); SimpleAdapter adapter new SimpleAdapter( this, getData(), R.layout.vlist, new String[]{title, info, img}, new int[]{R.id.title, R.id.info, R.id.img}); setListAdapter(adapter); } private ListMapString, Object getData() { ListMapString, Object list new ArrayList(); MapString, Object map new HashMap(); map.put(title, G1); map.put(info, google 1); map.put(img, R.drawable.i1); list.add(map); // 繼續(xù) add 更多 map... return list; } }SimpleAdapter 的后兩個參數(shù)是關(guān)鍵一個 String 數(shù)組表示 Map 的鍵一個 int 數(shù)組表示布局里組件的 id兩者按順序一一對應(yīng)完成映射。但真正要講復(fù)用必須繼承 BaseAdapter。行布局vlist2.xml在剛才基礎(chǔ)上加一個按鈕Button android:idid/view_btn android:layout_widthwrap_content android:layout_heightwrap_content android:textstring/s_view_btn android:focusablefalse android:layout_gravitybottom|right /注意android:focusablefalse不加這行按鈕會搶走 ListView 的焦點導(dǎo)致整行點不動。下面是帶 ViewHolder 復(fù)用的完整 Adapterpublic class MyAdapter extends BaseAdapter { private LayoutInflater mInflater; private ListMapString, Object mData; public MyAdapter(Context context, ListMapString, Object data) { this.mInflater LayoutInflater.from(context); this.mData data; } Override public int getCount() { return mData.size(); } Override public Object getItem(int position) { return mData.get(position); } Override public long getItemId(int position) { return position; } Override public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView null) { holder new ViewHolder(); convertView mInflater.inflate(R.layout.vlist2, null); holder.img convertView.findViewById(R.id.img); holder.title convertView.findViewById(R.id.title); holder.info convertView.findViewById(R.id.info); holder.viewBtn convertView.findViewById(R.id.view_btn); convertView.setTag(holder); } else { holder (ViewHolder) convertView.getTag(); } holder.img.setBackgroundResource((Integer) mData.get(position).get(img)); holder.title.setText((String) mData.get(position).get(title)); holder.info.setText((String) mData.get(position).get(info)); holder.viewBtn.setOnClickListener(v - showInfo()); return convertView; } public static class ViewHolder { public ImageView img; public TextView title; public TextView info; public Button viewBtn; } }Kotlin 版本更簡潔用ViewHolder加getTag/setTag思路完全一致class MyAdapter( private val context: Context, private val data: ListMapString, Any ) : BaseAdapter() { private val inflater LayoutInflater.from(context) override fun getCount(): Int data.size override fun getItem(position: Int): Any data[position] override fun getItemId(position: Int): Long position.toLong() override fun getView(position: Int, convertView: View?, parent: ViewGroup?): View { val view: View val holder: ViewHolder if (convertView null) { view inflater.inflate(R.layout.vlist2, parent, false) holder ViewHolder(view) view.tag holder } else { view convertView holder view.tag as ViewHolder } holder.title.text data[position][title] as String holder.info.text data[position][info] as String holder.img.setBackgroundResource(data[position][img] as Int) holder.viewBtn.setOnClickListener { showInfo() } return view } class ViewHolder(view: View) { val img: ImageView view.findViewById(R.id.img) val title: TextView view.findViewById(R.id.title) val info: TextView view.findViewById(R.id.info) val viewBtn: Button view.findViewById(R.id.view_btn) } }如果你在團(tuán)隊里用 Claude Code 或類似工具做長期編碼把這類 Adapter 模板沉淀成可復(fù)用片段會省很多事TaoToken Coding Plan 適合這種持續(xù)性的編碼場景。Key 的獲取在 TaoToken API Keys控制臺在 TaoToken Console。配置時記住三件套Base URL 填https://taotoken.net/apiKey 用你申請的那串Model ID 按文檔里對應(yīng)模型填三者缺一不可。4. 驗證請求跑起來看結(jié)果確認(rèn)復(fù)用真的生效代碼寫完后最直接的驗證就是跑一遍。用 ListActivity 承載時onCreate里setListAdapter(adapter)即可用普通 Activity 則先setContentView(R.layout.main)再findViewById拿到 ListView 調(diào)setAdapter。點擊事件分兩種。整行點擊重寫onListItemClickOverride protected void onListItemClick(ListView l, View v, int position, long id) { Log.v(MyListView4-click, (String) mData.get(position).get(title)); }行內(nèi)按鈕點擊則在getView里給按鈕單獨設(shè)監(jiān)聽彈個對話框public void showInfo() { new AlertDialog.Builder(this) .setTitle(我的listview) .setMessage(介紹...) .setPositiveButton(確定, null) .show(); }怎么確認(rèn) ViewHolder 復(fù)用生效在getView里加一行日志打印convertView null的次數(shù)Log.d(ListView, position position , convertView is null? (convertView null));滑動一個 100 條數(shù)據(jù)的列表你會看到前幾屏convertView為 null之后全是復(fù)用日志里 null 的次數(shù)穩(wěn)定在屏幕可見行數(shù)附近。如果每次滑動都打印 null說明復(fù)用沒生效多半是getView里每次都inflate了新布局或者setTag沒寫對。再驗證一下getCount()的作用把它臨時改成返回 0列表直接不顯示返回 1只顯示一行。這能幫你確認(rèn)數(shù)據(jù)長度確實由getCount()決定系統(tǒng)先調(diào)它拿到長度再逐行調(diào)getView繪制。如果你想讓模型幫你檢查這段日志邏輯或生成測試數(shù)據(jù)可以用 TaoToken 模型對話 貼代碼問但最終驗證一定要在真機(jī)或模擬器上跑日志和幀率不會騙人。5. 常見報錯排查從 401 到滑動卡頓對照真實錯誤逐個解決排障這塊我按真實遇到的報錯來列你可以對照自己的日志找。報錯一401 Unauthorized或local proxy failed。如果你在接入模型輔助編碼時遇到這個先檢查 Key 是否填對、Base URL 是否是https://taotoken.net/api。local proxy failed通常是本地代理配置和實際網(wǎng)絡(luò)環(huán)境沖突把代理關(guān)掉、直連 API 入口再試。這類問題跟 ListView 本身無關(guān)但會卡住你查文檔的節(jié)奏先解決掉。報錯二java.lang.NullPointerException在getView里。九成是convertView.getTag()拿到的不是 ViewHolder或者findViewById返回 null。檢查setTag(holder)是否在convertView null分支里執(zhí)行以及布局文件里 id 是否和代碼一致。報錯三reading choices相關(guān)解析失敗。這通常出現(xiàn)在你讓模型返回結(jié)構(gòu)化數(shù)據(jù)、結(jié)果格式不對時。解決辦法是在提示里明確要求返回 JSON并給出字段示例別讓它自由發(fā)揮。報錯四OAuth鑒權(quán)失敗。如果你用的是需要 OAuth 的編碼工具檢查 token 是否過期、回調(diào)地址是否配置正確。這類工具接入時同樣記住三件套Base URL、Key、Model ID缺一個都會鑒權(quán)失敗。報錯五滑動卡頓、掉幀。這是 ListView 最典型的性能問題。排查順序第一確認(rèn)getView里沒有做耗時操作比如讀文件、網(wǎng)絡(luò)請求、大量字符串拼接第二確認(rèn) ViewHolder 復(fù)用生效別每次inflate第三圖片加載別在主線程解碼大圖用 Glide 或 Coil 這類庫第四行布局層級別太深measure/layout次數(shù)會隨層級上升。我試過把行布局從五層壓到兩層滑動幀率肉眼可見地穩(wěn)了。報錯六按鈕點擊無響應(yīng)。前面提過給 Button 加android:focusablefalse否則它搶焦點導(dǎo)致整行點不動。如果按鈕和整行點擊都要響應(yīng)按鈕單獨設(shè)監(jiān)聽整行用onListItemClick。報錯七IllegalStateException: The content of the adapter has changed but ListView did not receive a notification。數(shù)據(jù)變了但沒通知刷新。改完數(shù)據(jù)源后調(diào)adapter.notifyDataSetChanged()并且確保數(shù)據(jù)修改在主線程。排查時建議開 GPU 渲染模式分析看每一幀的耗時條。如果某幀突然變長基本就是getView里藏了重活。把重活挪到異步或者用緩存卡頓會明顯改善。6. 把復(fù)用機(jī)制吃透再去看 RecyclerView 就順了ListView 的getView(position, convertView, parent)這三個參數(shù)其實把復(fù)用的全部秘密都擺在了明面上convertView就是系統(tǒng)回收給你的舊行視圖你復(fù)用它、更新數(shù)據(jù)、再返回就完成了一次復(fù)用。ViewHolder 只是把findViewById的結(jié)果緩存進(jìn)tag避免重復(fù)查找。這套思路在 RecyclerView 里被抽象成了onCreateViewHolder和onBindViewHolder兩個方法職責(zé)更清晰但底層邏輯一脈相承。所以別覺得 ListView 過時就不值得學(xué)。把 Adapter 綁定、ViewHolder 復(fù)用、點擊事件分發(fā)、getCount與getView的調(diào)用時機(jī)這幾件事親手寫一遍、跑一遍、用日志驗證一遍你對 Android 列表控件的理解就扎實了。真到用 RecyclerView 時你只需要關(guān)注它多出來的 LayoutManager 和 ItemDecoration核心的復(fù)用思想你已經(jīng)會了。最后留個實用習(xí)慣每次寫完 Adapter先在getView里打一行復(fù)用日志滑一遍確認(rèn) null 次數(shù)正常再刪日志。這個動作花不了兩分鐘但能幫你避開后面幾小時的卡頓排查。代碼跑起來日志看起來比看十篇教程都管用。