textbox.text赋值前必须确保控件已初始化，即initializecomponent()调用之后；多行需同时设multiline和acceptsreturn；监听文本变化应优先用textchanged事件并防死循环；中文输入需延迟校验或结合previewkeydown拦截。
TextBox.Text 属性赋值前必须确保控件已初始化
直接在窗体构造函数中写 textBox1.Text = "hello" 看似合理，但若该语句出现在 InitializeComponent() 调用之前，textBox1 仍为 null，运行时抛出 NullReferenceException。这是新手最常踩的坑。
- 务必把所有对
textBox1的访问放在InitializeComponent()之后（通常在构造函数末尾，或移到Form_Load事件里） - 在设计器中双击窗体空白处生成的
Form1_Load是更安全的初始化位置 - 如果使用 .NET 6+ 的 Windows Forms App 模板，注意
Program.cs中是否启用了「单文件」或「AOT」——某些 AOT 场景下设计器生成字段可能延迟初始化，此时应改用this.Controls.Find("textBox1", true)安全获取
多行 TextBox 需同时设置 AcceptsReturn 和 Multiline
只设 Multiline = true 不够，用户按 Enter 键仍会触发表单默认提交（比如点击确定按钮），而非换行。这是因为 Windows Forms 默认将 Enter 视为“确认”行为。
-
textBox1.Multiline = true启用多行显示 -
textBox1.AcceptsReturn = true允许 Enter 插入换行符（否则焦点会跳走） - 若还需支持 Tab 缩进，额外设
textBox1.AcceptsTab = true，否则 Tab 会切换焦点 - 注意：启用
Multiline后，TextAlign对垂直方向无效（无法设MiddleCenter），只能靠Padding或容器布局模拟居中
实时监听文本变化别用 KeyPress，优先选 TextChanged
用 KeyPress 或 KeyDown 做输入校验容易漏掉粘贴、拖放、剪贴板覆盖等非键盘路径，且难以处理 Ctrl+V、右键粘贴、IME 输入等场景。
-
TextChanged是唯一能捕获所有文本变更的事件（包括代码赋值、粘贴、撤销、自动完成） - 但要注意：在事件处理器中修改
Text会再次触发TextChanged，需加守卫避免死循环，例如：private void textBox1_TextChanged(object sender, EventArgs e) { if (textBox1.Text.Length > 100) { textBox1.Text = textBox1.Text.Substring(0, 100); textBox1.SelectionStart = textBox1.Text.Length; // 防止光标跳到开头 } } - 如需区分“用户输入”和“代码修改”，可用
Tag字段临时标记，或改用 MVVM 模式 + 绑定UpdateSourceTrigger=PropertyChanged
中文输入法下 TextChanged 可能触发多次
使用搜狗、微软拼音等 IME 输入中文时，一个汉字常经历“编码输入→候选框→确认”过程，期间 Text 会先设为拼音（如 "nihao"），再替换成汉字（如 "你好"）。这导致 TextChanged 至少触发两次，校验逻辑若未适配，可能误判中间态为非法输入。
- Windows Forms 本身不提供 IME 状态回调，无法直接判断是否处于“正在组词”阶段
- 稳妥做法是延迟校验：在
TextChanged中启动Timer（Interval=300），停顿后检查Text是否稳定；或监听ImeModeChanged作为辅助信号 - 若仅需过滤非法字符，建议用
PreviewKeyDown+e.SuppressKeyPress = true拦截按键，但注意它不拦截粘贴——所以仍要保留TextChanged的兜底校验
