Android ListView 資料填充完整指南：BaseAdapter 實現與 ViewHolder 優化

核心組件關係

ListView (視圖)
    │
    ▼ setAdapter()
BaseAdapter (橋樑) ◄── 資料源
    │
    ├── getCount()          → 多少行
    ├── getItem(position)   → 某行資料
    ├── getItemId(position) → 唯一 ID (穩定 ID 啟用優化)
    └── getView(position, convertView, parent) → 核心：行視圖創建/復用

最小可行實現 (Java)

public class MyAdapter extends BaseAdapter {
    private Context context;
    private List data; // 資料源
    
    public MyAdapter(Context context, List data) {
        this.context = context;
        this.data = data;
    }
    
    @Override public int getCount() { return data.size(); }
    @Override public Object getItem(int pos) { return data.get(pos); }
    @Override public long getItemId(int pos) { return pos; } // 簡單場景用 position
    
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = LayoutInflater.from(context).inflate(R.layout.list_item, parent, false);
            holder = new ViewHolder();
            holder.textView = convertView.findViewById(R.id.tv_text);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }
        // 綁定資料
        holder.textView.setText(data.get(position));
        return convertView;
    }
    
    static class ViewHolder {
        TextView textView;
    }
}

Activity 中使用

ListView listView = findViewById(R.id.listView);
List data = new ArrayList<>();
for (int i=0; i<20; i++) data.add("Item " + i);
MyAdapter adapter = new MyAdapter(this, data);
listView.setAdapter(adapter);

進階：動態更新資料

// 在 Adapter 中添加
public void updateData(List newData) {
    this.data.clear();
    this.data.addAll(newData);
    notifyDataSetChanged(); // 通知 ListView 重繪
}

// 支援插入/刪除單項 (配合動畫)
public void addItem(int pos, String item) {
    data.add(pos, item);
    notifyItemInserted(pos); // 需繼承 RecyclerView.Adapter 或自行實現動畫
}

Kotlin 簡化版 (擴展函數)

class MyAdapter(private val data: List) : BaseAdapter() {
    override fun getCount() = data.size
    override fun getItem(pos: Int) = data[pos]
    override fun getItemId(pos: Int) = pos.toLong()
    
    override fun getView(pos: Int, convertView: View?, parent: ViewGroup): View {
        val view = convertView ?: LayoutInflater.from(parent.context).inflate(R.layout.list_item, parent, false)
        view.findViewById(R.id.tv_text).text = data[pos]
        return view
    }
}

常見坑點與優化

現代替代：RecyclerView

新專案**強烈建議直接使用 RecyclerView**：

• 強制 ViewHolder 模式 (無 `convertView` 易錯邏輯)。
• 支援 `LinearLayoutManager`/`GridLayoutManager`/`StaggeredGridLayoutManager` 靈活佈局。
• 內建 `notifyItemInserted/Removed/Changed` 精細動畫。
• `DiffUtil` 高效增量更新。