1. ListView 数据展示为什么总在 Adapter 上翻车ListView 是 Android 里最经典的列表控件虽然现在 RecyclerView 更主流但大量存量项目、教学示例、外包老代码里依然是 ListView 的天下。它的核心链路其实就一句话数据源 → Adapter → ListView.setAdapter() → 渲染 item 布局。听起来简单但真正动手时新手最容易卡在三个地方item 布局的控件 id 对不上、Adapter 的 from/to 数组长度不一致、点击某一行拿不到对应数据。我见过太多人写完 SimpleAdapter 之后列表一片空白或者点击条目 Toast 出来的是 null。问题往往不在 ListView 本身而在数据绑定这一层没对齐。这篇就围绕「ListView 显示数据」这个场景把 Adapter 数据绑定、BaseAdapter 自定义布局、点击取数这三件事讲透同时把模型能力接进来——用 TaoToken 统一 Key 走一个 API 通道让列表里的数据可以来自模型返回而不是写死的假数据。适合谁看正在学 Android 列表控件、需要快速跑通 ListView 数据展示链路、又想顺手把大模型调用接进 App 的开发者。你不需要先精通网络请求我会把配置和验证步骤拆到可复制粘贴的程度。整篇的节奏是先讲清楚问题场景再给 TaoToken 的前置准备然后是可复制的 Adapter 配置代码接着验证请求是否成功最后把常见报错一个个排掉。需要先明确一点ListView 负责「显示」Adapter 负责「把数据翻译成 View」模型调用负责「生产数据」。三者解耦任何一环出问题都会表现为「列表不对」。所以排查时不要盯着 ListView 看要顺着数据流往回找。2. TaoToken 统一 Key 接入前置准备在写 Adapter 之前先把模型通道准备好。TaoToken 的作用是提供一个统一的 API 入口和统一的 Key你不用为每个模型单独维护一套鉴权和地址。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 注意 API 地址后面不加任何 UTM 参数保持干净。第一步去控制台创建 API Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后在 API Keys 页面新建一个 Key复制出来先存到安全的地方。这个 Key 就是后面所有请求的凭证形如 sk- 开头的一串字符。如果你还没决定用哪个模型可以先到模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 试跑一句确认通道是通的。第二步确认你要调用的模型 ID。不同模型 ID 不一样比如常见的对话模型、代码模型各有各的标识。这个 ID 会直接写进请求体写错了会返回模型不存在的错误。建议先在模型对话页面里选一个模型发一句话看返回正常再把它的 ID 记下来。第三步理解请求结构。TaoToken 的 API 兼容主流对话补全格式请求体里通常包含 model、messages 两个核心字段鉴权走 Authorization: Bearer 你的Key。这意味着你在 Android 里用 OkHttp 或 HttpURLConnection 都能直接发不需要引入特殊的 SDK。这里要提醒一句Key 不要硬编码进 APK 里明文提交到代码仓库。演示阶段可以放在常量里但正式项目建议走后端转发或至少做混淆。本文为了让你快速跑通会把它放在一个常量类里你上线前记得替换。准备好 Key 和模型 ID 之后我们就可以进入真正的 Adapter 环节了。记住这两个值后面配置里会反复用到。3. 可复制配置Adapter 数据绑定与 BaseAdapter 自定义布局这一节是全文的核心给你可以直接复制的代码。先定义 item 布局再写数据模型然后分别用 SimpleAdapter 和 BaseAdapter 两种方式绑定最后把模型返回的数据塞进列表。先建 item 布局文件 res/layout/item_person.xml三个 TextView 横向排列?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:orientationhorizontal android:layout_widthmatch_parent android:layout_heightwrap_content android:padding12dp TextView android:idid/personid android:layout_width80dp android:layout_heightwrap_content android:textSize14sp / TextView android:idid/name android:layout_width100dp android:layout_heightwrap_content android:textSize14sp / TextView android:idid/amount android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:textSize14sp / /LinearLayout注意这里的 id 是 personid、name、amount后面 from/to 数组必须和它们严格对应大小写都不能错。这是最常见的翻车点。接着定义数据模型 Personpublic class Person { private String personId; private String name; private String amount; public Person(String personId, String name, String amount) { this.personId personId; this.name name; this.amount amount; } public String getPersonId() { return personId; } public String getName() { return name; } public String getAmount() { return amount; } }方式一SimpleAdapter 快速绑定。适合字段固定、不需要复杂逻辑的场景ListHashMapString, Object data new ArrayList(); for (Person person : persons) { HashMapString, Object map new HashMap(); map.put(id, person.getPersonId()); map.put(name, person.getName()); map.put(amount, person.getAmount()); data.add(map); } SimpleAdapter adapter new SimpleAdapter( this, data, R.layout.item_person, new String[]{id, name, amount}, new int[]{R.id.personid, R.id.name, R.id.amount}); listView.setAdapter(adapter); listView.setOnItemClickListener((parent, view, position, id) - { HashMapString, Object item (HashMapString, Object) parent.getItemAtPosition(position); Toast.makeText(this, String.valueOf(item.get(id)), Toast.LENGTH_SHORT).show(); });方式二BaseAdapter 自定义布局。当你要在 item 里做条件渲染、加图片、加按钮时SimpleAdapter 就不够用了得自己写 ViewHolderpublic class PersonAdapter extends BaseAdapter { private final Context context; private final ListPerson persons; public PersonAdapter(Context context, ListPerson persons) { this.context context; this.persons persons; } Override public int getCount() { return persons.size(); } Override public Object getItem(int position) { return persons.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) { convertView LayoutInflater.from(context) .inflate(R.layout.item_person, parent, false); holder new ViewHolder(); holder.personId convertView.findViewById(R.id.personid); holder.name convertView.findViewById(R.id.name); holder.amount convertView.findViewById(R.id.amount); convertView.setTag(holder); } else { holder (ViewHolder) convertView.getTag(); } Person person persons.get(position); holder.personId.setText(person.getPersonId()); holder.name.setText(person.getName()); holder.amount.setText(person.getAmount()); return convertView; } static class ViewHolder { TextView personId; TextView name; TextView amount; } }绑定到 ListViewPersonAdapter adapter new PersonAdapter(this, persons); listView.setAdapter(adapter);现在把模型数据接进来。用 OkHttp 发一个请求到 TaoToken把返回内容解析后填进 persons 列表再刷新 Adapter。请求配置如下public class TaoTokenConfig { public static final String BASE_URL https://taotoken.net/api; public static final String API_KEY sk-你的Key; public static final String MODEL_ID 你的模型ID; }OkHttpClient client new OkHttpClient(); String json {\model\:\ TaoTokenConfig.MODEL_ID \, \messages\:[{\role\:\user\,\content\:\返回三条人员数据\}]}; Request request new Request.Builder() .url(TaoTokenConfig.BASE_URL /v1/chat/completions) .addHeader(Authorization, Bearer TaoTokenConfig.API_KEY) .addHeader(Content-Type, application/json) .post(RequestBody.create(json, MediaType.parse(application/json))) .build(); client.newCall(request).enqueue(new Callback() { Override public void onFailure(Call call, IOException e) { runOnUiThread(() - Toast.makeText(MainActivity.this, 请求失败: e.getMessage(), Toast.LENGTH_SHORT).show()); } Override public void onResponse(Call call, Response response) throws IOException { String body response.body().string(); // 解析 body取出内容构造 Person 列表 ListPerson persons parsePersons(body); runOnUiThread(() - { adapter.setData(persons); adapter.notifyDataSetChanged(); }); } });注意 UI 更新必须回到主线程网络回调是在子线程里的直接操作 Adapter 会崩。这一点在 ListView 场景里特别容易忘。4. 验证请求与列表渲染成功结果配置写完怎么确认整条链路是通的分两步验证先验证 API 通道再验证列表渲染。验证 API 通道最直接的方式是用 curl 在终端打一发排除 Android 代码本身的干扰curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 你好}] }如果返回里能看到 choices 数组和 content 字段说明 Key、模型 ID、地址三者都对。如果返回 401是 Key 问题返回模型不存在是模型 ID 问题连接超时是网络或地址问题。这一步过了再回到 Android。验证列表渲染跑起来后观察三件事列表是否显示了预期条数的 item每一行的三个字段是否落在正确的列上点击某一行Toast 是否弹出了对应的 personid。如果列表空白先看 getCount() 返回是不是 0再看数据源是不是在 setAdapter 之后才填充。如果字段错位检查 from 数组和 to 数组的顺序是否一一对应。一个实测有效的技巧在 getView 里临时打日志把 position 和 person.getName() 打出来确认数据确实到了 Adapter 层。如果日志有数据但界面没显示问题在布局如果日志都没数据问题在数据源或网络回调。成功的结果应该是App 启动后列表自动加载模型返回的数据每行显示编号、名称、金额点击任意一行弹出该行编号。到这一步ListView 数据展示链路就算跑通了。5. 本篇常见报错排查对照这一节把真实会遇到的报错列出来对照着排。401 Unauthorized。这是鉴权失败九成是 Key 写错或没带上。检查 Authorization 头是不是 Bearer 加空格再加 Key检查 Key 有没有多余空格或换行。如果你用的是环境变量注入确认变量真的传进去了。local proxy failed 或连接被拒绝。这类报错通常出现在你本地配了网络工具的情况下请求没走到目标地址。先确认 BASE_URL 是 https://taotoken.net/api 不要多加斜杠或路径。如果你在模拟器里跑确认模拟器网络正常必要时用真机试。reading choices 时抛空指针。说明返回体里没有 choices 字段可能是请求体格式不对或者模型 ID 写错导致返回了错误结构。先把返回的原始 body 完整打出来看不要直接解析。常见原因是 messages 数组为空或者 content 字段拼错了。OAuth 相关报错。如果你在别的工具里配过 OAuth 流程注意 TaoToken 这里走的是 API Key不是 OAuth 授权码。别把两套鉴权混用Header 里只放 Bearer Key 就够了。列表显示空白但无报错。检查三点数据源是否为空、setAdapter 是否在数据填充之后调用、item 布局的根布局高度是不是 wrap_content 而不是 0。还有一个隐蔽点SimpleAdapter 的 from 数组里的 key必须和 HashMap 里 put 的 key 完全一致。点击条目取到 null。SimpleAdapter 场景下getItemAtPosition 返回的是 HashMap强转类型要对BaseAdapter 场景下返回的是你的 Person 对象别按 HashMap 取。另外确认 onItemClick 里用的是 parent.getItemAtPosition(position)不是 listView 的别的引用。字段错位。from 是 {id,name,amount}to 是 {R.id.personid, R.id.name, R.id.amount}两个数组按下标一一对应。你把 name 放到 personid 的位置显示就会串。改的时候两个数组一起改。如果你用的是 Cline MCP 或 Claude Code 这类工具来辅助生成 Adapter 代码记得把三件套配全Base URL 填 https://taotoken.net/api Key 填你的 sk- 开头凭证Model ID 填你选的模型标识。缺任何一个都会连不上。Codex 的 auth.json 里同理地址和 Key 要对齐。6. 把模型能力接进列表的下一步列表跑通之后你可以做几件更有意思的事。第一把模型返回的结构化数据直接映射成 Person 列表让列表内容动态生成而不是写死。第二在 item 里加一个按钮点击后针对该行数据再发一次模型请求做二次加工。第三把 Adapter 抽成泛型基类让不同数据类型的列表复用同一套绑定逻辑。如果你打算长期在项目里用模型能力建议了解一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合需要持续调用、做 Agent 类功能的场景。日常调试和验证模型返回用模型对话页面就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。Key 的管理和新建在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题先翻文档。最后留一个我踩过的坑ListView 的 item 布局里如果用了 weight记得把对应方向的宽度设成 0dp否则 weight 不生效三个字段会挤在一起。这个和 Adapter 无关但表现上很像数据绑定出错排查时容易绕远路。