企业官网建设流程全解析

1. 光标消失这件事，先别急着改 EditText

Android 里 EditText 光标不显示，是个看起来很小、排查起来很烦的问题。它可能表现为：点击输入框能弹出输入法、能打字，但光标就是不闪；也可能表现为光标颜色和背景一样，肉眼看不见；还有一种是光标只在某些机型上消失，换台手机又正常。核心检索词就三个：Android、EditText、光标。能做什么？这篇会把「控件属性 → 主题继承 → 工具链配置」三层排查路径讲清楚，适合正在做 Android 输入框、搜索框、验证码框的开发者，也适合用 AI 辅助写代码、需要统一管理 Key 与配置骨架的同学。

很多人第一反应是去搜「EditText 光标不显示怎么办」，然后复制一堆属性进去，结果有的生效有的不生效。原因在于：光标可见性不只由 EditText 自己决定，它还受主题里的colorControlActivated、textCursorDrawable、输入法状态、甚至你项目里 AI 工具链的配置文件影响。我试过在一个多模块项目里，同一个 EditText 在 A 模块正常、B 模块消失，最后发现是 B 模块的主题覆盖了光标颜色。

所以这篇不打算只给你三行属性就结束，而是按「先定位层级，再动手改」的顺序来。前半段讲 Android 侧的控件与主题排查，后半段讲怎么用 TaoToken 的 config.toml 与 settings.json 骨架，把 AI 编码工具的 Key/API 通道统一起来，避免工具链配置混乱反过来干扰你判断问题。两条线看似不相关，但排查思路是一致的：先看配置骨架，再看具体属性。

2. TaoToken 前置：统一 Key 与 API 通道，配置骨架先立住

在动手改 EditText 之前，先把工具链这一层理清楚。TaoToken 是一个面向 AI 编码与模型调用的统一入口，官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。它的作用是让你用一套 Key 和一套配置骨架，去对接不同的模型与编码工具，而不是每个工具各配一份、互相打架。

为什么排查光标问题要提这个？因为现在很多 Android 项目会用 AI 辅助生成代码、补全配置。如果你的 coding 工具配置散落在多个文件里，改一个属性可能被另一个工具的格式化规则覆盖，排查时就会误判「属性没生效」。把 Key 和 API 通道统一到 config.toml 与 settings.json 两个骨架文件里，能减少这种干扰。

你需要先拿到 API Key。进入控制台创建：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，然后在 API Keys 页面生成：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。生成后不要硬编码进代码，而是写进配置文件，用环境变量或本地配置读取。

如果你只是想在排查过程中快速验证模型输出、对照配置写法，可以直接用模型对话页：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。如果你长期做 Android 编码、需要 Agent 持续补全，建议了解 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入细节看文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

注意：Key 只放在本地配置文件或环境变量里，不要提交到 Git 仓库。config.toml 和 settings.json 建议加入 .gitignore。

3. 可复制配置：config.toml 与 settings.json 骨架

这一节给你两份可直接复制的骨架。config.toml 偏工具链与模型通道，settings.json 偏编辑器/插件侧的行为。两者配合，能让你的 AI 编码工具读取同一套 Key 和 API 地址。

先看 config.toml：

# config.toml —— TaoToken 统一通道骨架 # 官方入口: https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= [provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key_env = "TAOTOKEN_API_KEY" # 从环境变量读取，避免硬编码 [model] default = "claude-sonnet" # 按需替换为你在控制台看到的模型名 timeout_seconds = 60 max_retries = 2 [workspace] project_root = "." respect_gitignore = true exclude = ["build/", ".gradle/", "*.apk"]

再看 settings.json：

{ "taotoken": { "apiBase": "https://taotoken.net/api", "apiKeyEnv": "TAOTOKEN_API_KEY", "defaultModel": "claude-sonnet", "requestTimeoutMs": 60000 }, "editor": { "formatOnSave": false, "trimTrailingWhitespace": true }, "android": { "lintOnSave": true, "cursorDebug": true } }

这两份骨架的关键点：api_key_env和apiKeyEnv都指向同一个环境变量，这样无论工具读 toml 还是 json，拿到的都是同一把 Key。base_url和apiBase都指向 https://taotoken.net/api ，不重复配置。formatOnSave设为 false，是为了排查期间避免格式化把 EditText 属性顺序改掉，干扰你判断。

设置环境变量的方式，Linux/macOS：

export TAOTOKEN_API_KEY="你的Key"

Windows PowerShell：

$env:TAOTOKEN_API_KEY="你的Key"

配好之后，工具链这一层就稳定了。接下来回到 Android 侧，按层级排查光标。

3.1 第一层：EditText 控件属性

最直接的一层。在布局 XML 里给 EditText 加属性：

<EditText android:id="@+id/et_input" android:layout_width="match_parent" android:layout_height="wrap_content" android:cursorVisible="true" android:textCursorDrawable="@null" android:inputType="text|textMultiLine" android:textColor="@color/text_primary" android:background="@drawable/bg_input" />

android:cursorVisible="true"是显式声明光标可见。android:textCursorDrawable="@null"表示用系统默认光标，避免自定义 drawable 加载失败导致光标消失。android:inputType用text|textMultiLine，不要用textCapSentences，部分国内机型对该 flag 支持不一致，容易连带影响光标渲染。

如果你需要自定义光标颜色和宽度，用 drawable：

<!-- res/drawable/cursor_green.xml --> <?xml version="1.0" encoding="utf-8"?> <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle"> <size android:width="2dp" /> <solid android:color="#008000" /> </shape>

然后在 EditText 里引用：

android:textCursorDrawable="@drawable/cursor_green"

3.2 第二层：主题继承与 colorControlActivated

如果控件属性都对了，光标还是不显示，往主题查。在res/values/themes.xml里：

<style name="Theme.App" parent="Theme.MaterialComponents.DayNight"> <item name="colorControlActivated">@color/cursor_color</item> <item name="android:textColorHighlight">@color/selection_color</item> </style>

colorControlActivated会影响光标和控件的激活色。如果它被设成和背景同色，光标就「隐身」了。检查你的colors.xml：

<color name="cursor_color">#FF000000</color> <color name="selection_color">#33000000</color>

排查时可以把colorControlActivated临时设成高对比色，比如#FF00FF，看光标是否出现。出现就说明是颜色问题，不是可见性问题。

3.3 第三层：输入法与窗口焦点

有些情况是输入法抢了焦点，或者 EditText 所在窗口windowSoftInputMode配置不当。在AndroidManifest.xml里：

<activity android:name=".MainActivity" android:windowSoftInputMode="adjustResize|stateAlwaysVisible" />

adjustResize让布局随输入法调整，stateAlwaysVisible让输入法状态更稳定。另外确认 EditText 是focusable="true"且focusableInTouchMode="true"，否则点击后拿不到焦点，自然没有光标。

4. 验证请求：确认配置生效与光标出现

配置改完，怎么验证？分两步：先验证工具链通道通不通，再验证 Android 侧光标是否出现。

验证 TaoToken 通道，用 curl 发一个最小请求：

curl -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet", "messages": [{"role": "user", "content": "回复 OK"}], "max_tokens": 16 }'

如果返回里有正常的 JSON 结构和内容，说明 Key 与 API 地址配置正确。这一步能排除「工具链配置错误导致代码没被正确生成」的可能。

验证 Android 光标，用日志确认焦点状态：

val et = findViewById<EditText>(R.id.et_input) et.requestFocus() et.setSelection(et.text?.length ?: 0) Log.d("CursorDebug", "hasFocus=${et.hasFocus()}, selection=${et.selectionStart}")

运行后看 Logcat，如果hasFocus=true且selection有值，但光标仍不显示，基本锁定在主题颜色或 drawable 层。如果hasFocus=false，回到第 3.3 节查焦点与输入法。

成功结果应该是：点击输入框，光标出现并闪烁，输入文字时光标跟随，切换深浅色主题后光标颜色仍可辨认。

5. 本篇常见错排查

排查过程中，下面这些坑最容易踩。

第一个坑：textCursorDrawable指向的 drawable 文件不存在或写错路径。资源编译期可能不报错，运行期光标直接消失。解决方法是先设@null用系统默认，确认光标出现后再换自定义。

第二个坑：主题里colorControlActivated被全局设成透明或与背景同色。表现是「所有输入框都没光标」。解决方法是全局搜这个属性，临时改成高对比色验证。

第三个坑：inputType用了textCapSentences或none。部分机型对textCapSentences处理不一致，none则可能让输入框行为异常。统一用text|textMultiLine。

第四个坑：工具链配置文件里formatOnSave开着，保存时把android:cursorVisible属性重排或删掉。回到第 3 节的 settings.json，把formatOnSave设为 false 再排查。

第五个坑：Key 硬编码进代码后提交，或者 config.toml 与 settings.json 里的环境变量名不一致，导致工具读不到 Key，生成的代码片段不完整。对照两份骨架，确认api_key_env与apiKeyEnv同名。

第六个坑：多模块项目里，子模块主题覆盖了主模块。检查每个模块的themes.xml，确认没有重复定义colorControlActivated。

提示：排查顺序建议固定为「控件属性 → 主题 → 输入法/焦点 → 工具链配置」，每次只改一层，改完立即验证，避免多层同时改动导致无法定位。

6. 继续接入与验证

如果你已经把 config.toml 和 settings.json 骨架立起来，接下来可以按用途分流：排查接入类问题，去 API Keys 页面确认 Key 状态，再看接入文档核对参数，地址分别是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 和 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ；想快速验证模型输出、对照配置写法，用模型对话页 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ；长期做 Android 编码、需要 Agent 持续补全，看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

回到 EditText 光标这件事，最后给你一个实用技巧：在colors.xml里单独定义cursor_color，主题和 drawable 都引用它，这样改一处就能全局生效。排查时先把它设成#FF00FF，光标出现后再换成正式颜色。这个习惯能帮你把「颜色问题」和「可见性问题」快速分开，少走弯路。