WinForms TextBox自动补全需先设AutoCompleteSource再设AutoCompleteMode，用AutoCompleteSource.CustomSource配合AutoCompleteCustomSource填词，AutoCompleteMode.SuggestAppend最常用；动态更新须重赋新AutoCompleteStringCollection；中文匹配失败多因候选词含空格或大小写混乱。
WinForms 里 TextBox 怎么接上自动补全提示？
直接用 autocompletemode + autocompletesource 就行，不用写事件监听或弹窗逻辑。关键在控件初始化后设置这两个属性，顺序不能反——必须先设 autocompletesource，再设 autocompletemode，否则提示不生效。
-
AutoCompleteSource = AutoCompleteSource.CustomSource是最常用的选择，配合AutoCompleteCustomSource手动填入候选词 -
AutoCompleteMode = AutoCompleteMode.SuggestAppend最实用：下拉提示 + 输入时自动补全右侧文字 - 如果只想要下拉（不补全），用
AutoCompleteMode.Suggest；如果只补全不显示列表，用AutoCompleteMode.Append - 候选词必须是字符串数组或
AutoCompleteStringCollection，传List会静默失败
怎么动态更新 AutoCompleteCustomSource 的内容？
不能直接改 AutoCompleteCustomSource 里已有的集合引用，WinForms 不监听变更。每次更新都要重新赋值整个新集合。
- 别这么写：
textBox1.AutoCompleteCustomSource.Add("new item")—— 界面不会刷新 - 正确做法：构造新
AutoCompleteStringCollection，AddRange后再赋给AutoCompleteCustomSource - 如果数据来自异步请求（比如搜索 API），记得在 UI 线程更新，否则抛
InvalidOperationException - 大量候选词（>1000）会导致下拉卡顿，建议加长度截断或前端过滤后再塞进集合
WPF 或 Blazor 能不能用这套 API？
不能。AutoCompleteMode 和 AutoCompleteSource 是 WinForms 专属，WPF 的 TextBox 没有内置补全支持，Blazor 更是完全不提供。
- WPF 需要自己组合
TextBox+Popup+ListBox，或用第三方库如MaterialDesignThemes的AutoSuggestBox - Blazor 可用
+oninput触发 JS 或 C# 过滤，再渲染或自定义下拉组件 - 别试图把 WinForms 的
AutoCompleteCustomSource移植过去——类型和生命周期都不兼容
为什么输入中文时提示总不出现？
常见原因是候选词里混了首字母大小写不一致的词，而 WinForms 默认按“单词开头匹配”，且对 Unicode 处理较弱。中文没首字母概念，它就干脆不触发。
- 确保所有候选词都是纯字符串，不含前后空格或不可见字符（比如
\u200b） - 避免在
AutoCompleteCustomSource里塞重复项，重复会干扰匹配逻辑 - 如果必须支持模糊匹配（比如输“北”出“北京”“北海”），就得放弃原生方案，改用
TextChanged事件手动筛选 +ComboBox模拟下拉 - 调试时打印
textBox1.AutoCompleteCustomSource.Count，为 0 就说明集合根本没设进去
实际用起来最麻烦的不是设参数，而是候选数据源的时机控制和中英文混合场景下的匹配预期管理。很多人卡在“明明代码一样，别人能出提示我不能”，八成是集合赋值早于控件加载完成，或者候选词里藏了空字符串。
