1. 为什么表单里的 EditText 需要“能点不能改”
做 Android 表单的同学大概率遇到过这种需求：页面上有个输入框，值必须由程序算出来或者从接口回填，用户只能看、不能手敲。典型场景有订单号、设备序列号、时间戳、优惠券码、由定位反查出来的地址，以及各种“只读但需要复制”的字段。
最直觉的做法是setEnabled(false)，但你会发现文字变灰、点击没反应，连长按复制都做不到，体验很差。另一个直觉是setFocusable(false)，结果在某些 ROM 上点击依然会弹出软键盘，光标还在闪。还有人用InputType.TYPE_NULL，键盘是不弹了，但setText()之后文字显示异常，甚至光标位置错乱。
这些坑的根源在于：“能不能获得焦点”“能不能被触摸聚焦”“软键盘要不要弹”“输入法类型是什么”是四件独立的事，只改其中一个往往按下葫芦浮起瓢。我试过在真机上逐个组合验证，最后总结出一套稳定的配置组合，配合InputMethodManager主动隐藏，基本能覆盖绝大多数表单场景。
这篇就围绕“EditText 阻止手动输入 + 隐藏软键盘 + 保留程序化赋值”这条主线，把可复制的 XML 属性、Kotlin/Java 代码、真机验证动作和常见报错排查一次讲清楚。同时，因为很多表单的值来自后端接口，我会顺带说明如何用 TaoToken 的统一 Key 通道去拉取这些回填数据，让“只读输入框”真正跑通端到端流程。如果你正在做 Android 表单、设备信息页或者任何需要“展示型输入框”的界面，这篇可以直接照着改。
核心检索词先明确：Android EditText 禁止手动输入、隐藏软键盘、保留 setText 赋值，这三件事要一起解决，而不是分开处理。
2. TaoToken 统一 Key 接入：让回填数据有稳定来源
只读输入框本身不产生数据，它的值通常来自两个地方：本地计算，或者远程接口。远程接口这一环，很多团队会踩到“每个模型/服务一个 Key、一个 Base URL”的坑，代码里散落着各种鉴权逻辑，换个环境就要改一堆配置。TaoToken 的思路是把这些收敛成一套统一的 Key 和 API 通道，Android 端只需要认一个 Base URL 和一个 Key。
对 Android 表单场景来说，这意味着回填逻辑可以写得很干净：一个网络层、一个 Key、一个模型 ID，剩下的交给业务代码。你可以在官网了解整体能力，API 入口统一走https://taotoken.net/api，不要带多余参数。
具体到“只读输入框回填”这个需求，链路是这样的：Activity 启动 → 调用接口拿数据 → 解析出字段 →editText.setText(value)。因为输入框已经禁用了手动输入，用户改不了，数据一致性反而更好保证。这里的关键是接口调用要稳定，Key 要能复用，不然每次联调都在换配置，效率很低。
TaoToken 的 Coding Plan 适合长期做 Android 客户端 + 后端联调的团队，模型对话入口可以用来快速验证接口返回结构，接入文档里有各语言的调用示例。我建议的做法是：先在模型对话里把请求体和返回体调通，确认字段名和类型，再落到 Android 代码里。这样能避免在真机上反复改 JSON 解析。
需要提醒的是，TaoToken 是 API 通道，不是编辑器替代品，也不做灰色中转。Android 端该写的网络层、该做的错误处理一样不能少。把 Key 管好、把 Base URL 配对，是接入的第一原则。
对于表单回填，我一般会把网络请求放在 ViewModel 里，用协程处理，Activity 只负责观察 LiveData 然后 setText。这样即使接口慢，UI 也不会卡，输入框的只读状态也不会因为异步回调而错乱。
3. 可复制的 EditText 配置与隐藏软键盘代码
这一节是全文的核心，直接给能粘贴进项目的配置。分三块：XML 属性、Kotlin 代码、以及一个完整的 settings 风格片段方便你对照。
3.1 XML 层：让输入框“可点、可复制、不可编辑”
最稳的组合是这几个属性一起上：
<EditText android:id="@+id/etReadonly" android:layout_width="match_parent" android:layout_height="wrap_content" android:hint="设备序列号" android:textColor="#333333" android:textSize="16sp" android:background="@drawable/bg_input_readonly" android:cursorVisible="false" android:focusable="false" android:focusableInTouchMode="false" android:inputType="none" android:longClickable="true" android:textIsSelectable="true" android:showSoftInputOnFocus="false" />逐个解释为什么这么配：
android:cursorVisible="false"让光标不闪，视觉上就不像可编辑。android:focusable="false"和android:focusableInTouchMode="false"一起用，阻止它通过点击或键盘导航获得焦点。android:inputType="none"从输入法类型层面关掉输入能力。android:showSoftInputOnFocus="false"是 API 21+ 的属性，明确告诉系统“聚焦也别弹键盘”，比只靠TYPE_NULL更可靠。android:textIsSelectable="true"和longClickable="true"保留长按选择、复制的能力，用户能复制订单号，体验不降级。
注意inputType="none"和inputType="TYPE_NULL"在 XML 里写法不同，XML 用none，代码里用InputType.TYPE_NULL，别混。
3.2 Kotlin 代码：主动隐藏软键盘 + 保留 setText
XML 配好之后，再加一层代码兜底，尤其是页面里还有其他可编辑输入框时，切换焦点可能把键盘带出来。
class FormActivity : AppCompatActivity() { private lateinit var etReadonly: EditText override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_form) etReadonly = findViewById(R.id.etReadonly) // 兜底：即使被聚焦也不弹键盘 etReadonly.showSoftInputOnFocus = false etReadonly.inputType = InputType.TYPE_NULL etReadonly.isCursorVisible = false etReadonly.isFocusable = false etReadonly.isFocusableInTouchMode = false // 点击时主动收起可能已弹出的键盘 etReadonly.setOnClickListener { hideSoftKeyboard(etReadonly) } // 程序化赋值，依然生效 etReadonly.setText("SN-2024-0001") } private fun hideSoftKeyboard(view: View) { val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager imm.hideSoftInputFromWindow(view.windowToken, 0) } }hideSoftInputFromWindow的第二个参数传 0 表示不附加额外 flag，够用。如果你希望切换页面时也收起键盘，可以在onPause里对当前焦点 View 调一次。
3.3 一份可对照的配置片段
把关键属性整理成类似 settings 的对照表，方便你按需取用：
{ "editTextReadonly": { "cursorVisible": false, "focusable": false, "focusableInTouchMode": false, "inputType": "none", "showSoftInputOnFocus": false, "longClickable": true, "textIsSelectable": true }, "activityManifest": { "windowSoftInputMode": "stateHidden|adjustResize" }, "runtime": { "hideSoftInputFromWindow": true, "clearFocusOnPause": true } }Manifest 里对应 Activity 加上：
<activity android:name=".FormActivity" android:windowSoftInputMode="stateHidden|adjustResize" />stateHidden保证进入页面时键盘不自动弹，adjustResize保证键盘弹出时布局正确收缩。这两个配合，页面切换时的键盘行为会稳定很多。
3.4 关于外层 Layout 的 focusableInTouchMode
有些老方案会在 EditText 外层套一个focusableInTouchMode="true"的 LinearLayout，目的是抢焦点、阻止 EditText 获得焦点。这个做法在部分场景有效，但副作用是外层布局会先拿到焦点，可能影响其他控件的焦点顺序。我的建议是：优先用 EditText 自身的属性解决，外层布局方案作为最后手段，且要测试无障碍（TalkBack）下的焦点流转是否正常。
4. 真机验证：点击无键盘、setText 仍生效
配置写完不算完，必须真机验证。模拟器的输入法行为和真机差异不小，尤其是国产 ROM，所以一定要上真机。
验证动作分三步：
第一步，进入页面，观察软键盘是否自动弹出。正常情况下应该不弹，因为 Manifest 里配了stateHidden，EditText 又是showSoftInputOnFocus=false。
第二步，用手指点击只读输入框。预期结果是：没有键盘弹出，光标不闪，但长按能出现选择/复制菜单。如果键盘弹了，说明某个属性没生效，回到第 3 节逐项检查。
第三步，触发程序化赋值。可以在页面加一个按钮，点击后调用etReadonly.setText("SN-TEST-9999")，确认文字正常显示、不报错、光标位置不异常。这一步是很多人忽略的：有些方案禁用了输入，结果setText也不生效了，那就本末倒置。
如果你要验证接口回填，可以接上 TaoToken 的通道，在 ViewModel 里请求数据后 setText。验证模型返回结构可以用模型对话入口，确认字段后再写解析代码。这样三步下来，输入框的“只读 + 可复制 + 可赋值”就闭环了。
补充一个细节：在onResume里可以再调一次hideSoftKeyboard，防止从其他页面返回时键盘残留。实测下来，加上这一步后，页面切换的键盘异常基本消失。
5. 常见报错与排查：401、local proxy failed、reading choices
这一节列几个真实会遇到的报错，以及对应的排查方向。注意，这些报错大多出现在“接口回填”环节，而不是 EditText 本身，但两者经常一起出现，所以放一起讲。
401 Unauthorized：接口鉴权失败。检查 TaoToken 的 Key 是否正确、是否过期、请求头格式对不对。Android 端常见错误是把 Key 拼进了 URL 而不是放在 Header 里。正确做法是Authorization: Bearer <你的Key>，Base URL 用https://taotoken.net/api，不要多加路径。
local proxy failed：本地网络层或代理配置问题。Android 模拟器访问本机服务要用10.0.2.2，真机要用局域网 IP。如果你在 OkHttp 里配了拦截器或自定义 DNS，先注释掉再试。这个报错和输入框无关，但会阻断回填数据，导致 setText 拿不到值。
reading choices 相关解析错误：通常是返回体结构和解析模型不匹配。比如接口返回的是choices[0].message.content，你按data.result去解析，自然读不到。解决办法是先用模型对话把返回体打印出来，确认字段路径，再改数据类。Kotlin 里用@SerializedName对齐字段名，能省很多事。
OAuth 相关报错：如果你用的是需要 OAuth 的通道，检查 token 刷新逻辑。Android 端建议把刷新放在拦截器里统一处理，避免每个请求都写一遍。
键盘仍然弹出：回到第 3 节，确认showSoftInputOnFocus=false和inputType=none都配了，且没有在代码里被覆盖。有些第三方输入法会忽略部分属性，这时用hideSoftInputFromWindow在点击回调里主动收起。
setText 不生效：检查是不是把inputType设成了非法值，或者isFocusable=false之后又调用了requestFocus。另外，如果在TextWatcher里做了过滤逻辑，可能把程序化赋值也拦掉了，记得加标志位区分用户输入和程序赋值。
排查顺序建议：先确认 EditText 属性，再确认键盘隐藏逻辑，最后确认接口回填链路。分层排查，比一股脑改代码高效得多。
6. 把只读输入框接进你的表单流程
到这里，EditText 的只读配置、软键盘隐藏、真机验证和报错排查都过了一遍。回到实际项目，我建议你把这几件事固化下来：在项目里建一个ReadonlyEditText的自定义 View，把第 3 节的属性默认写好，业务里直接用，避免每个页面重复配。回填数据统一走 ViewModel + 协程，Key 和 Base URL 收敛到一处配置。
如果你还在为接口鉴权和多环境切换头疼，可以从 API Keys 页面拿到统一 Key，再对照接入文档把网络层搭起来。需要长期做编码和联调的，Coding Plan 会更省心；只是想先验证返回结构的，用模型对话快速试一把就行。把输入控制做扎实，把数据通道理顺，Android 表单的体验和稳定性都会上一个台阶。
