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