简介这是一份基于C# WinForm平台开发的富文本编辑器实战项目面向C#初学者与WinForm进阶开发者帮助快速掌握RichTextBox控件的核心功能封装与UI交互设计。资源完整实现了加粗、斜体、下划线、字体颜色/背景色设置、多级对齐左/中/右、段落缩进与反缩进、项目符号与编号列表、图片插入、内容查找及打印等典型编辑功能代码结构清晰含15个.cs源文件如MainForm、RichFormatFactory、BaseRichFormat等支撑功能分层6个.gif操作动图直观展示界面效果3个.exe可执行文件便于即刻运行验证辅以.sln/.csproj工程文件和.resx资源文件保障开箱即用。压缩包共66个文件总大小174KB轻量紧凑且模块划分明确。目前已有642人学习下载读者可直接获取可运行的完整工程、规范的格式工厂设计模式实践、丰富的UI图标资源及配套配置文件是理解WinForm富文本处理机制的优质参考范例。1. 为什么一个“WinForm RichTextBox”的文本编辑器至今仍是产线工具开发的首选落地形态你可能在 GitHub 上扫过几十个“C# 文本编辑器”项目点开一看WPF 渲染、MVVM 绑定、插件系统、语法高亮引擎……但真要给工厂 MES 系统配个日志查看器给设备调试软件加个配置脚本编辑区或者给内部 QA 工具嵌一个可保存的测试用例输入框——最后上线的八成还是 WinForm RichTextBox 搭出来的那个灰扑扑、没动画、右键菜单只有“复制/粘贴/全选”的小窗体。这不是技术倒退而是 WinForm 的 RichTextBox 在低耦合、零依赖、强可控、易维护四个维度上至今没被任何上层框架真正替代。它不依赖 .NET Core 运行时不卡在 DPI 缩放黑盒里不因 WPF 渲染线程挂掉而整个窗体失响应更不会因为某个 NuGet 包版本冲突就编译不过。本文不讲“如何用 RichTextBox 显示一段文字”而是聚焦真实产线场景如何让这个控件撑起一个能保存 UTF-8 带 BOM 的配置文件、支持 CtrlZ/Y 多级撤销、保留原始缩进与换行符、右键菜单按上下文动态启用、状态栏实时显示光标行列号与编码格式的轻量级文本编辑器。适合正在用 VS2015/VS2019 开发工业软件、设备配套工具、内部运维平台的 C# 工程师——你不需要重构整个 UI 层只要把这一块“文本编辑能力”稳稳焊死在现有 WinForm 窗体里。2. 从空窗体到可编辑RichTextBox 初始化与基础行为接管RichTextBox 不是拿来即用的“编辑器”它默认行为对生产环境而言太“野”CtrlA 会选中整个控件包括不可见的滚动条区域、Enter 键插入的是\r\n而非\n、撤销栈在窗口失去焦点后自动清空、字体缩放会破坏行高一致性。我们必须在初始化阶段就“驯服”它而不是等用户反馈“为什么我按 CtrlZ 没反应”。2.1 创建最小可运行窗体并禁用默认干扰行为新建 WinForm 项目VS2015 或更高拖入 RichTextBox 控件命名为rtbEditor。关键不是把它放上去而是立刻在Form_Load中执行以下初始化private void Form1_Load(object sender, EventArgs e) { // 1. 强制使用固定宽度字体避免中文/英文混排错位产线日志常见问题 rtbEditor.Font new Font(Consolas, 10f, FontStyle.Regular); // 2. 关闭自动换行保证日志/配置文件原始格式不被破坏 rtbEditor.WordWrap false; // 3. 禁用 RichTextBox 自带的右键菜单我们自己实现否则无法控制“粘贴”是否触发格式清理 rtbEditor.ContextMenuStrip null; rtbEditor.ShortcutsEnabled false; // 关键禁用内置快捷键否则 CtrlZ/Y 会被劫持 // 4. 启用多级撤销默认只有一级必须显式开启 rtbEditor.EnableAutoDragDrop false; // 防止拖放文本污染撤销栈 rtbEditor.UndoLimit 100; // 设为 100 级足够覆盖常规编辑深度 // 5. 设置默认文本模式为纯文本绕过 RTF 解析开销提升大文件加载速度 rtbEditor.Text string.Empty; }提示ShortcutsEnabled false是血泪经验。很多团队卡在“CtrlZ 不生效”查半天发现是 RichTextBox 内置快捷键和自定义命令冲突。关掉它所有快捷键由我们统一捕获处理控制权才真正回来。2.2 手动接管 CtrlZ / CtrlY 撤销重做逻辑RichTextBox 的Undo()和Redo()方法必须在用户操作后显式调用且需配合CanUndo/CanRedo状态判断。我们用KeyDown事件做拦截private void rtbEditor_KeyDown(object sender, KeyEventArgs e) { // 拦截 CtrlZ撤销 if (e.Control e.KeyCode Keys.Z) { e.SuppressKeyPress true; // 阻止系统默认行为 if (rtbEditor.CanUndo) { rtbEditor.Undo(); UpdateStatusBar(); // 后续章节实现 } } // 拦截 CtrlY重做 else if (e.Control e.KeyCode Keys.Y) { e.SuppressKeyPress true; if (rtbEditor.CanRedo) { rtbEditor.Redo(); UpdateStatusBar(); } } // 拦截 CtrlS保存——此处仅占位实际保存逻辑见第 4 章 else if (e.Control e.KeyCode Keys.S) { e.SuppressKeyPress true; SaveCurrentFile(); } }这段代码的逻辑重点在于SuppressKeyPress true必须设置否则 Windows 会同时触发 RichTextBox 内置 Undo 和你的Undo()调用导致撤销栈错乱。实测中未加此行会导致连续按两次 CtrlZ 后第三次按失效——因为撤销栈被重复消费了。2.3 行列号与编码状态实时反馈状态栏驱动的光标监听产线人员看日志最怕“第 127 行出错”却找不到光标在哪。我们需要在状态栏StatusStripToolStripStatusLabel中实时显示当前光标位置与文件编码。关键不是获取位置而是在每次光标移动、内容变更后精准触发更新// 在窗体设计器中添加 StatusStrip内含两个 ToolStripStatusLabeltslblPosition 和 tslblEncoding private void rtbEditor_SelectionChanged(object sender, EventArgs e) { // 获取光标所在行号基于 \n 计数兼容 \r\n 和 \n int line rtbEditor.GetLineFromCharIndex(rtbEditor.SelectionStart) 1; int col rtbEditor.SelectionStart - rtbEditor.GetFirstCharIndexFromLine(line - 1) 1; tslblPosition.Text $Ln {line}, Col {col}; // 更新编码显示实际编码需在加载/保存时确定此处设为占位 tslblEncoding.Text UTF-8; } private void rtbEditor_TextChanged(object sender, EventArgs e) { // 内容变更时也刷新位置如粘贴后光标跳到末尾 rtbEditor_SelectionChanged(sender, e); }注意GetLineFromCharIndex返回的是基于\n的行号对 Windows 风格的\r\n自动兼容无需手动替换。这是 .NET Framework 对 RichTextBox 的底层优化不必自行解析字符串。3. 文件读写与编码控制为什么 UTF-8 带 BOM 是产线配置文件的硬性要求产线设备厂商提供的配置文件90% 是 Notepad 保存的 UTF-8 with BOM 格式。如果编辑器用Encoding.UTF8直接读取BOM0xEF 0xBB 0xBF会被当作可见字符显示为导致设备解析失败。反之若用Encoding.Default通常是 GBK又会把英文日志中的©、®符号变成乱码。必须在读写两端严格控制 BOM 行为。3.1 安全读取自动识别 BOM 并剥离同时记录原始编码不能依赖文件扩展名必须读取文件头字节判断。我们封装一个ReadTextWithEncoding方法public static (string content, Encoding encoding) ReadTextWithEncoding(string filePath) { if (!File.Exists(filePath)) return (string.Empty, Encoding.UTF8); byte[] buffer File.ReadAllBytes(filePath); if (buffer.Length 2) return (Encoding.UTF8.GetString(buffer), Encoding.UTF8); // 检查 UTF-8 BOM: EF BB BF if (buffer.Length 3 buffer[0] 0xEF buffer[1] 0xBB buffer[2] 0xBF) { byte[] contentBytes new byte[buffer.Length - 3]; Array.Copy(buffer, 3, contentBytes, 0, contentBytes.Length); return (Encoding.UTF8.GetString(contentBytes), new UTF8Encoding(true)); // true 表示保留 BOM } // 检查 UTF-16 BE BOM: FE FF if (buffer.Length 2 buffer[0] 0xFE buffer[1] 0xFF) { byte[] contentBytes new byte[buffer.Length - 2]; Array.Copy(buffer, 2, contentBytes, 0, contentBytes.Length); return (Encoding.BigEndianUnicode.GetString(contentBytes), Encoding.BigEndianUnicode); } // 检查 UTF-16 LE BOM: FF FE if (buffer.Length 2 buffer[0] 0xFF buffer[1] 0xFE) { byte[] contentBytes new byte[buffer.Length - 2]; Array.Copy(buffer, 2, contentBytes, 0, contentBytes.Length); return (Encoding.Unicode.GetString(contentBytes), Encoding.Unicode); } // 无 BOM按 UTF-8 尝试解码产线日志绝大多数为 UTF-8 try { return (Encoding.UTF8.GetString(buffer), Encoding.UTF8); } catch { // UTF-8 解码失败降级为系统默认编码GBK return (Encoding.Default.GetString(buffer), Encoding.Default); } }注意new UTF8Encoding(true)中的true参数表示“生成 BOM”这是后续保存时的关键。很多团队误用Encoding.UTF8其Preamble为空导致保存后设备无法识别。3.2 可靠保存强制写入 UTF-8 with BOM且保留原始换行符用户可能在 Linux 服务器上生成\n换行的日志也可能在 Windows 上生成\r\n的配置。RichTextBox 内部统一用\r\n存储但保存时必须还原原始风格——否则设备固件解析会失败。我们通过Lines属性获取每行文本再手动拼接private bool SaveToFile(string filePath, Encoding targetEncoding) { try { // 获取原始行数组保留 RichTextBox 内部的 \r\n string[] lines rtbEditor.Lines; // 按目标编码生成字节流 byte[] preamble targetEncoding.GetPreamble(); Listbyte allBytes new Listbyte(preamble); for (int i 0; i lines.Length; i) { byte[] lineBytes targetEncoding.GetBytes(lines[i]); allBytes.AddRange(lineBytes); // 末行不加换行符其余行加 \r\nWindows 风格 if (i lines.Length - 1) { allBytes.AddRange(new byte[] { 0x0D, 0x0A }); // \r\n } } File.WriteAllBytes(filePath, allBytes.ToArray()); return true; } catch (Exception ex) { MessageBox.Show($保存失败{ex.Message}, 错误, MessageBoxButtons.OK, MessageBoxIcon.Error); return false; } } // 调用示例保存为 UTF-8 with BOM private void SaveCurrentFile() { if (string.IsNullOrEmpty(currentFilePath)) { SaveAsDialog(); return; } SaveToFile(currentFilePath, new UTF8Encoding(true)); }这里的关键是不用File.WriteAllText而用File.WriteAllBytes 手动拼接字节。因为WriteAllText会强制使用\r\n且无法控制 BOM 写入时机。手动拼接让我们完全掌控每个字节满足设备固件对文件格式的苛刻要求。4. 右键菜单与上下文感知一个菜单项的启用逻辑比想象中复杂产线工具的右键菜单不是“复制/粘贴/全选”三件套而是需要根据光标位置、选中文本长度、当前是否为只读状态动态启停。例如当光标在空白行时“注释行”应禁用当选中 1000 行日志时“转为 CSV”才可用当文件以只读方式打开时所有编辑类菜单项必须灰显。4.1 构建动态右键菜单ToolStripDropDownMenu 状态驱动在窗体设计器中添加ContextMenuStrip命名为cmsEditor添加以下菜单项tmiUndo撤销tmiRedo重做tmiSeparator1tmiCut剪切tmiCopy复制tmiPaste粘贴tmiDelete删除tmiSeparator2tmiSelectAll全选tmiSeparator3tmiCommentLine注释行tmiUncommentLine取消注释然后绑定Opening事件在菜单弹出前计算每一项的Enabled状态private void cmsEditor_Opening(object sender, CancelEventArgs e) { // 所有项默认禁用按条件逐个启用 tmiUndo.Enabled rtbEditor.CanUndo; tmiRedo.Enabled rtbEditor.CanRedo; bool hasSelection rtbEditor.SelectionLength 0; bool isReadOnly rtbEditor.ReadOnly; tmiCut.Enabled hasSelection !isReadOnly; tmiCopy.Enabled hasSelection; tmiPaste.Enabled !isReadOnly; tmiDelete.Enabled hasSelection !isReadOnly; tmiSelectAll.Enabled rtbEditor.TextLength 0; // 注释/取消注释仅当有选中文本且每行首字符非 # 时启用 if (hasSelection) { string selectedText rtbEditor.SelectedText; string[] lines selectedText.Split(new[] { \r, \n }, StringSplitOptions.RemoveEmptyEntries); bool allLinesStartWithHash lines.All(l l.TrimStart().StartsWith(#)); tmiCommentLine.Enabled !allLinesStartWithHash !isReadOnly; tmiUncommentLine.Enabled allLinesStartWithHash !isReadOnly; } else { tmiCommentLine.Enabled tmiUncommentLine.Enabled false; } }4.2 实现“注释行”与“取消注释行”精准定位行首不破坏缩进这是产线配置编辑的核心功能。不能简单地在每行开头加#必须保留原有缩进否则设备固件会因格式错误拒绝加载private void tmiCommentLine_Click(object sender, EventArgs e) { if (rtbEditor.SelectionLength 0) return; string selectedText rtbEditor.SelectedText; string[] lines selectedText.Split(new[] { \r, \n }, StringSplitOptions.None); // 保留空行和换行符 Liststring newLines new Liststring(); foreach (string line in lines) { if (string.IsNullOrWhiteSpace(line)) { newLines.Add(line); continue; } // 查找行首非空白字符位置 int firstNonWs line.IndexOfAny(new char[] { , \t }); if (firstNonWs -1) { // 全是空白直接加 # newLines.Add(# line); } else { // 提取缩进部分再加 # string indent line.Substring(0, firstNonWs); string rest line.Substring(firstNonWs); newLines.Add(indent # rest); } } string newText string.Join(\r\n, newLines); rtbEditor.SelectedText newText; } private void tmiUncommentLine_Click(object sender, EventArgs e) { if (rtbEditor.SelectionLength 0) return; string selectedText rtbEditor.SelectedText; string[] lines selectedText.Split(new[] { \r, \n }, StringSplitOptions.None); Liststring newLines new Liststring(); foreach (string line in lines) { if (string.IsNullOrWhiteSpace(line)) { newLines.Add(line); continue; } string trimmed line.TrimStart(); if (trimmed.StartsWith(#)) { // 移除第一个 # 及其后的空格 string afterHash trimmed.Substring(1).TrimStart(); string indent line.Substring(0, line.Length - trimmed.Length); newLines.Add(indent afterHash); } else { newLines.Add(line); } } string newText string.Join(\r\n, newLines); rtbEditor.SelectedText newText; }玄学细节Split(StringSplitOptions.None)保留原始换行符结构避免\r\n被拆成两个空行TrimStart()后再Substring(1)是为了安全移除#后可能存在的多个空格确保“取消注释”后格式干净。5. 避坑指南那些让产线同事凌晨三点打电话给你的 RichTextBox 陷阱这些不是文档里写的“注意事项”而是我在三个不同工厂 MES 项目中被现场电话轰炸后记下的真实翻车现场。每一条都附带现象、根因和可立即抄走的修复代码。5.1 现象在高 DPI 缩放125%/150%的 Win10 电脑上RichTextBox 滚动条消失或错位原因RichTextBox 默认不支持 DPI 感知缩放后控件尺寸计算失准滚动条渲染区域被裁剪。解决在Program.cs的Main方法顶部添加 DPI 感知声明并禁用自动缩放[STAThread] static void Main() { // 添加此行启用系统 DPI 感知 SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2); Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); Application.Run(new Form1()); } // P/Invoke 声明 [DllImport(user32.dll)] private static extern bool SetProcessDpiAwarenessContext(IntPtr value); private const IntPtr DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 (IntPtr)(-4);提示仅靠Application.SetHighDpiMode(HighDpiMode.PerMonitorV2)不够必须调用原生 API。VS2015 项目需手动添加user32.dll引用。5.2 现象加载 10MB 以上日志文件时RichTextBox 卡死超过 30 秒CPU 占用 100%原因RichTextBox 在Text属性赋值时会触发完整重绘大文本下性能灾难。解决改用AppendText分块加载并禁用重绘private void LoadLargeFile(string filePath) { rtbEditor.SuspendLayout(); // 关键暂停布局和重绘 rtbEditor.Clear(); const int chunkSize 64 * 1024; // 64KB 每次 using (var reader new StreamReader(filePath, detectEncodingFromByteOrderMarks: true)) { char[] buffer new char[chunkSize]; int read; while ((read reader.Read(buffer, 0, buffer.Length)) 0) { string chunk new string(buffer, 0, read); rtbEditor.AppendText(chunk); } } rtbEditor.ResumeLayout(); // 恢复重绘 rtbEditor.ScrollToCaret(); // 滚动到末尾 }5.3 现象用户用鼠标拖选大段文本后松手瞬间光标跳到文件开头原因RichTextBox 在SelectionChanged事件中调用ScrollToCaret()会重置滚动位置。解决记录原始滚动位置仅在必要时恢复private int lastVerticalScroll 0; private void rtbEditor_VScroll(object sender, EventArgs e) { lastVerticalScroll rtbEditor.GetScrollPos(SB_VERT); } private void rtbEditor_SelectionChanged(object sender, EventArgs e) { // ... 其他逻辑 // 注释掉原有的 ScrollToCaret() // rtbEditor.ScrollToCaret(); // 改为仅当光标移出可视区时才滚动 Rectangle rect rtbEditor.GetPositionFromCharIndex(rtbEditor.SelectionStart); Rectangle clientRect rtbEditor.ClientRectangle; if (rect.Top clientRect.Top || rect.Bottom clientRect.Bottom) { rtbEditor.ScrollToCaret(); } }5.4 现象粘贴从 Excel 复制的表格时RichTextBox 显示为乱码方块原因Excel 复制的是 HTML 或 UnicodeText 格式RichTextBox 默认尝试解析 RTF失败后回退为乱码。解决在Paste菜单项中强制提取纯文本private void tmiPaste_Click(object sender, EventArgs e) { if (!Clipboard.ContainsText(TextDataFormat.UnicodeText)) return; string plainText Clipboard.GetText(TextDataFormat.UnicodeText); // 清理 Excel 特有的制表符和换行符 plainText plainText.Replace(\t, ).Replace(\r\n, \n); rtbEditor.Paste(plainText); }5.5 现象程序退出时未保存的修改提示框点击“取消”后窗体仍关闭原因FormClosing事件中e.Cancel true未阻止默认关闭流程。解决在FormClosing中检查修改状态并手动取消private void Form1_FormClosing(object sender, FormClosingEventArgs e) { if (rtbEditor.Modified) { DialogResult result MessageBox.Show(文档已修改是否保存, 确认, MessageBoxButtons.YesNoCancel, MessageBoxIcon.Warning); if (result DialogResult.Yes) { if (!SaveCurrentFile()) e.Cancel true; // 保存失败则不退出 } else if (result DialogResult.Cancel) { e.Cancel true; // 关键阻止关闭 } } }6. 进阶技巧用 RichTextBox 实现“只读日志查看器”与“可编辑配置区”的双模切换产线工具常需同一界面承载两种角色左侧是只读日志流实时追加、自动滚动、禁止编辑右侧是可编辑的设备参数配置区支持撤销、注释、保存。很多人用两个 RichTextBox 控件硬切结果内存暴涨、焦点管理混乱。其实只需一个 RichTextBox通过属性组合实现“逻辑双模”。6.1 定义双模状态枚举与切换方法public enum EditorMode { ReadOnlyLog, // 只读日志模式禁用编辑、自动滚动、无撤销 EditableConfig // 可编辑配置模式启用全部功能 } private EditorMode currentMode EditorMode.EditableConfig; public void SetEditorMode(EditorMode mode) { currentMode mode; switch (mode) { case EditorMode.ReadOnlyLog: rtbEditor.ReadOnly true; rtbEditor.ShortcutsEnabled false; rtbEditor.UndoLimit 0; // 彻底禁用撤销栈 rtbEditor.ScrollBars RichTextBoxScrollBars.Vertical; break; case EditorMode.EditableConfig: rtbEditor.ReadOnly false; rtbEditor.ShortcutsEnabled false; // 仍由我们接管快捷键 rtbEditor.UndoLimit 100; rtbEditor.ScrollBars RichTextBoxScrollBars.Both; break; } UpdateMenuState(); // 刷新右键菜单 }6.2 日志模式下的高效追加避免闪烁与卡顿只读日志的核心是“追加即显示”但频繁AppendText会触发重绘抖动。我们用SuspendLayoutAppendTextResumeLayout组合并控制滚动private void AppendLogLine(string line) { if (currentMode ! EditorMode.ReadOnlyLog) return; rtbEditor.SuspendLayout(); // 防止日志爆炸限制最大行数如 10000 行 const int maxLines 10000; if (rtbEditor.Lines.Length maxLines) { string[] lines rtbEditor.Lines; string[] keepLines lines.Skip(lines.Length - maxLines).ToArray(); rtbEditor.Lines keepLines; rtbEditor.SelectionStart rtbEditor.TextLength; } rtbEditor.AppendText(line \r\n); // 仅当光标在末尾时才滚动避免用户手动拖动后被强制拉回 if (rtbEditor.SelectionStart rtbEditor.TextLength) { rtbEditor.ScrollToCaret(); } rtbEditor.ResumeLayout(); }6.3 配置模式下的结构化编辑用正则预校验防止非法输入设备配置文件常有严格格式如BAUDRATE115200。我们可在TextChanged中实时校验并高亮错误行private void rtbEditor_TextChanged(object sender, EventArgs e) { if (currentMode ! EditorMode.EditableConfig) return; // 示例校验所有行是否符合 KEYVALUE 格式 string[] lines rtbEditor.Lines; for (int i 0; i lines.Length; i) { string line lines[i].Trim(); if (!string.IsNullOrEmpty(line) !line.StartsWith(#) !Regex.IsMatch(line, ^\w\s*\s*.$)) { // 高亮整行背景为浅红 rtbEditor.Select(rtbEditor.GetFirstCharIndexFromLine(i), line.Length); rtbEditor.SelectionBackColor Color.LightCoral; break; // 只高亮第一个错误 } } // 清除其他行的高亮简化版实际项目中建议用更精细的范围管理 rtbEditor.SelectAll(); rtbEditor.SelectionBackColor Color.White; rtbEditor.SelectionLength 0; }我的习惯在产线工具中从不依赖用户“自觉遵守格式”。而是用 RichTextBox 的SelectionBackColor做即时视觉反馈比弹窗警告更高效。用户看到红色高亮自然会修正——这比写 100 行验证逻辑再弹 5 个 MessageBox 更接近真实工作流。希望帮到你。本文还有配套的精品资源点击获取