企业官网建设流程全解析

1. 进入页面光标乱弹？先搞懂 EditText 焦点与光标的关系

做 Android 表单页时，EditText 的光标行为经常让人抓狂：一进页面软键盘自动弹出来、光标在输入框里闪个不停；切换 Fragment 后旧输入框的光标还残留着；明明在 XML 里写了自定义 drawable，光标样式却死活不生效。这些问题的根子，其实都绕不开两个概念——焦点（Focus）和光标可见性（CursorVisible）。

很多人把它们当成一回事，实际上它们是两套独立机制。requestFocus()决定的是「这个 View 是否成为输入焦点」，而setCursorVisible(true/false)决定的是「获得焦点后光标画不画出来」。一个 EditText 可以持有焦点但光标隐藏，也可以光标可见却没焦点（虽然这种状态很短暂）。理解这一点，后面所有配置才不会互相打架。

这篇内容面向的是正在做 Android 表单、搜索框、验证码输入等场景的开发者，尤其是被「自动弹光标」「焦点残留」「自定义光标失效」折磨过的同学。我会给出 XML 属性和代码控制两套可复制配置，再补上焦点变化监听、软键盘联动、光标闪烁开关的验证步骤。你不需要是资深 Android 工程师，只要会写基本的 Activity 和布局就能跟着做。

先说结论性的判断：光标显隐问题，90% 是焦点时机没控制好，剩下 10% 是 cursorVisible 和 inputType 的组合踩了坑。比如inputType设成none时，即使cursorVisible=true，光标也可能不显示；再比如在onCreate里立刻调requestFocus()，此时 View 还没 attach 到窗口，焦点请求会被丢弃，导致「代码写了但没效果」。

我试过在一个搜索页里同时踩了三个坑：进页面自动弹键盘、返回后光标残留、自定义光标颜色不生效。最后发现分别是windowSoftInputMode、clearFocus()调用时机、以及textCursorDrawable版本兼容的问题。下面按「问题场景 → 前置准备 → 可复制配置 → 验证 → 排障 → 工具」的顺序展开，你可以直接跳到需要的章节。

2. 用 TaoToken 快速验证光标控制代码片段

在动手改项目之前，有个很实际的问题：光标显隐这种小逻辑，单独建个工程测试太麻烦，但直接改主项目又怕影响别人。我的做法是先用一个轻量的模型对话环境，把关键代码片段和报错信息丢进去快速确认思路，尤其是涉及不同 API 版本行为差异的时候。

TaoToken 在这里的定位是一个统一的模型调用入口，你可以把它理解成「一个 API Key 就能访问多种模型」的聚合层。对于 Android 开发场景，它比较实用的地方在于：当你对某段焦点控制代码的行为不确定时，可以直接把代码和现象描述贴进去，让它帮你分析是 API 版本问题还是调用顺序问题。它本身不是编辑器，也不替代 Android Studio，只是一个辅助验证和排查的工具。

如果你只是想快速验证「这段 requestFocus 代码在 API 30 上会不会有兼容问题」，用模型对话就够了，地址是 https://taotoken.net/api 对应的对话入口。如果你在做长期的 Android 项目，需要反复调试焦点、输入法、光标这类细节，可以考虑 Coding Plan，把常用的排查 prompt 固化下来，省得每次重新组织语言。

需要提前说明的是，TaoToken 提供的是模型调用能力，不涉及任何网络访问层面的操作，你只需要在正常网络环境下获取 API Key 即可。获取 Key 的入口在控制台的 API Keys 页面，拿到之后无论是接对话还是接编码辅助，用的都是同一个 Key。

这里给一个实际的使用思路：把下面这段「问题描述模板」存下来，遇到光标问题时替换具体现象即可。

场景：Android EditText 光标控制 现象：进入页面后光标自动显示并弹出软键盘，但我没有调用 requestFocus 已尝试：在 XML 设置 cursorVisible=false，在 onCreate 调用 clearFocus 期望：进入页面不显示光标，用户点击输入框后才显示 请分析可能原因，并给出 API 21 到 API 34 都兼容的写法

这种描述方式比只贴一行代码有效得多，因为模型能根据「已尝试」和「期望」缩小排查范围。实测下来，把版本范围写清楚，得到的建议会具体很多，不会给你一堆泛泛的「检查焦点」之类的废话。

3. 可复制的 XML 与代码配置：光标显隐两套方案

这一节是核心，给出两套可以直接抄的配置。第一套是 XML 属性方案，适合静态控制；第二套是代码控制方案，适合动态切换。两套可以混用，但要注意优先级：代码里调用的setCursorVisible()会覆盖 XML 的android:cursorVisible。

3.1 XML 属性方案

先看布局文件。下面这个 EditText 配置了「默认不显示光标、不自动获取焦点、点击后才进入输入态」的行为：

<EditText android:id="@+id/et_input" android:layout_width="match_parent" android:layout_height="wrap_content" android:hint="请输入内容" android:cursorVisible="false" android:focusable="true" android:focusableInTouchMode="true" android:inputType="text" android:textCursorDrawable="@drawable/cursor_style" />

几个关键属性逐个说明。android:cursorVisible="false"让光标默认隐藏，但注意它只在获得焦点后才起作用，如果 View 根本没焦点，这个属性看不出效果。android:focusableInTouchMode="true"是让 EditText 在触摸模式下也能获取焦点，这是点击输入框能弹出键盘的前提。android:textCursorDrawable指定自定义光标样式，这个属性在 API 29 及以上才稳定支持，低版本可能被忽略。

自定义光标的 drawable 可以这样写，控制颜色和宽度：

<!-- res/drawable/cursor_style.xml --> <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle"> <solid android:color="#FF3B30" /> <size android:width="2dp" /> </shape>

如果你想让光标宽度随字体大小变化，把size的 width 去掉，改用android:padding配合，但实测固定 2dp 在大多数场景下视觉最稳。

3.2 代码控制方案

XML 管静态，代码管动态。下面这段是「进入页面隐藏光标、点击后显示、失焦后再次隐藏」的完整逻辑：

class MainActivity : AppCompatActivity() { private lateinit var etInput: EditText override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) etInput = findViewById(R.id.et_input) // 初始状态：隐藏光标，不主动请求焦点 etInput.isCursorVisible = false etInput.setOnFocusChangeListener { _, hasFocus -> if (hasFocus) { // 获得焦点时才显示光标 etInput.isCursorVisible = true } else { // 失去焦点时隐藏光标，避免残留 etInput.isCursorVisible = false } } } // 需要主动唤起输入时调用 private fun showCursorAndKeyboard() { etInput.requestFocus() etInput.isCursorVisible = true val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager imm.showSoftInput(etInput, InputMethodManager.SHOW_IMPLICIT) } // 需要收起时调用 private fun hideCursorAndKeyboard() { etInput.clearFocus() etInput.isCursorVisible = false val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager imm.hideSoftInputFromWindow(etInput.windowToken, 0) } }

这段代码的关键在于顺序：先requestFocus()再setCursorVisible(true)，反过来在某些机型上光标不会立即刷新。clearFocus()和setCursorVisible(false)同理，先清焦点再隐藏光标，避免出现「有焦点但光标不显示」的中间态。

3.3 光标闪烁开关

如果你需要控制光标是否闪烁（比如某些阅读类输入场景希望光标常亮），可以用反射或者 API 29 之后的setCursorBlinkRate思路。标准做法是通过TextView的隐藏方法，但更稳妥的是用textCursorDrawable配合自定义动画。简单场景下，直接控制isCursorVisible的切换频率也能达到类似效果，但不推荐，因为会干扰输入法。

一个更实用的技巧：在onWindowFocusChanged里统一处理光标状态，避免 Activity 切换时残留：

override fun onWindowFocusChanged(hasFocus: Boolean) { super.onWindowFocusChanged(hasFocus) if (!hasFocus) { etInput.isCursorVisible = false } }

这样从其他页面返回时，光标不会莫名其妙地闪。

4. 验证请求与成功结果：焦点、键盘、光标三步确认

配置写完不算完，得验证。下面给出一套可复现的验证步骤，覆盖焦点变化、软键盘联动、光标闪烁三个维度。

4.1 验证焦点变化

在setOnFocusChangeListener里加日志，观察焦点流转：

etInput.setOnFocusChangeListener { _, hasFocus -> Log.d("CursorDebug", "hasFocus=$hasFocus, cursorVisible=${etInput.isCursorVisible}") etInput.isCursorVisible = hasFocus }

预期结果：进入页面时日志显示hasFocus=false, cursorVisible=false；点击输入框后变成hasFocus=true, cursorVisible=true；点击其他区域后回到hasFocus=false, cursorVisible=false。如果点击后hasFocus一直是 false，检查focusableInTouchMode是否设置正确。

4.2 验证软键盘联动

软键盘的弹出和收起，受windowSoftInputMode影响很大。在 AndroidManifest.xml 里这样配置：

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

stateHidden表示进入页面时键盘不自动弹出，adjustResize让布局随键盘调整。验证方法：进入页面观察键盘是否弹出；点击输入框观察键盘是否弹出；按返回键观察键盘是否收起且光标是否隐藏。

如果进入页面键盘还是自动弹出，检查是否有其他 View 抢先获取了焦点，或者EditText的inputType触发了自动弹出。可以在根布局加android:focusableInTouchMode="true"来「截胡」焦点。

4.3 验证光标闪烁与自定义样式

自定义光标是否生效，最直接的方法是运行后截图对比。如果textCursorDrawable不生效，先确认 API 版本，再确认 drawable 的 shape 是否正确。一个常见错误是把size的 width 设成 0dp，导致光标不可见。

验证闪烁：正常状态下光标应该有节奏地闪烁。如果光标常亮不闪，可能是输入法或系统设置影响，不一定是代码问题。可以在不同机型上对比，排除系统差异。

成功的结果应该是：进入页面无光标无键盘；点击输入框光标出现、键盘弹出；切换焦点光标消失；自定义光标颜色和宽度符合预期。三步都通过，说明配置稳定。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

这一节对照真实报错，帮你快速定位。虽然这些报错多出现在 API 调用场景，但排查思路对 Android 光标问题同样适用——都是「配置没对齐」导致的。

401 未授权：如果你在用模型辅助排查时遇到 401，通常是 API Key 没带对或过期。检查请求头里的 Authorization 字段，确认 Key 是从控制台正确复制的。对应到 Android 场景，类似「权限没申请就调用」——比如没在 Manifest 里声明就操作输入法。

local proxy failed：这个报错一般出现在本地网络配置层面。排查方向是确认请求地址是否可达、端口是否被占用。Android 里类似的问题是windowToken为空时调用hideSoftInputFromWindow，会静默失败，表现为「键盘收不起来」。

reading choices 报错：这类报错通常和响应解析有关，说明返回结构和你预期的不一致。对应到光标问题，就是「你以为setCursorVisible(true)会立即生效，但实际上要等下一帧」。解决办法是用post延迟一帧执行：

etInput.post { etInput.isCursorVisible = true }

OAuth 相关报错：涉及授权流程时，常见问题是回调地址不匹配或 token 过期。Android 场景里类似的是onActivityResult回调时机，如果你在 Fragment 里处理输入结果，注意用registerForActivityResult替代旧 API。

如果你在接入 TaoToken 时遇到上述报错，排查顺序建议是：先确认 Key 有效（对应 401），再确认网络可达（对应 local proxy failed），最后确认请求体和响应格式（对应 reading choices）。接入文档在 https://taotoken.net/api 对应的文档页有详细说明，遇到具体报错可以对照查。

另外提醒一点：如果你同时用了 CC Switch、Cline MCP 或 Codex 这类工具，配置时务必写全三件套——Base URL、Key、Model ID。缺任何一个都会导致连接失败，表现出的报错往往和真实原因不直接相关，容易误导排查方向。

6. 稳定控制光标行为的长期实践建议

光标显隐看起来是小问题，但在真实项目里，它和焦点管理、输入法状态、页面生命周期紧密耦合。我的经验是：不要试图用一行代码解决所有场景，而是建立一套统一的焦点管理策略。

具体做法是：在 BaseActivity 或 BaseFragment 里封装showInput()和hideInput()两个方法，所有页面统一调用，避免每个页面各写一套。光标状态跟着焦点走，焦点跟着用户操作走，不要主动在onCreate里抢焦点。

对于需要长期做 Android 输入相关开发的同学，可以把常用的排查 prompt 和配置片段整理成自己的知识库。如果你需要反复调用模型来验证代码行为，Coding Plan 会比单次对话更划算，适合把「焦点排查」「输入法联动」这类高频问题固化下来。

最后给一个实用技巧：在开发阶段打开「显示布局边界」和「指针位置」，能直观看到 EditText 的焦点区域和光标位置，比看日志快得多。等配置稳定后，再把调试代码去掉。光标控制这件事，验证比写代码更重要，多在不同 API 版本和机型上跑一遍，比读十篇文档都管用。