简介富文本编辑是桌面应用开发中的常见需求TRichView作为Delphi/CBuilder/Lazarus生态下的专业控件提供了完整的文档对象模型和丰富的编辑功能。本文从富文本控件的基本概念出发解析TRichView 23.1版本包中XE7-D12与Lazarus FS的版本兼容性原理说明其在VCL与LCL间API一致而安装方式不同的技术要点。结合工程实践给出在Delphi 12和Lazarus中编译安装、配置Library Path/Other Unit Files、验证最小例程的完整步骤并针对IDE崩溃、控件丢失、编码乱码、跨平台差异等高频问题提供排查思路。无论你是RichView新手还是老项目升级掌握这些方法都能有效减少踩坑快速构建稳定的富文本编辑功能。 这几天在整理组件目录时翻出一个TRichView-23.1-XE7-D12 Lazarus FS.7z安装包刚好手头Delphi 12和Lazarus两头跑就顺手把两个IDE里的富文本编辑需求都切到了这个版本上。TRichView是我这些年用下来在Delphi/Lazarus体系里最省心的富文本控件之一但这个包涉及XE7到D12、还有Lazarus FS版本不看清楚很容易装错装完又会出现各种IDE崩溃、控件丢失的问题。这篇文章就把拆包、安装、踩坑和常见用法一次说清楚。1. 项目背景与版本兼容性解析1.1 TRichView是什么解决什么问题TRichView是一套专门给Delphi、CBuilder以及Lazarus使用的第三方富文本编辑控件核心目标是在你的程序里实现“类WordPad”的所见即所得编辑能力。它不只支持简单的加粗、斜体、字体颜色还能处理图片、表格、列表、超链接、段落编号、多级撤销重做这些功能如果完全用原生TEdit、TMemo去堆开发量会非常恐怖。我第一次接触这个控件是在做一个通用报告编辑工具时需求是把数据库里查出来的结构化数据动态生成一份带格式的Word风格文档。用TMemo做原型光是处理图片和表格就写了三周后来换成TRichView不到两天就把核心功能跑通了。它最核心的价值是提供了完整的文档对象模型你不需要维护一套自己的“文本格式”数据结构直接操作控件内部文档就能实现加载、保存、编辑、打印全流程。1.2 版本号里藏着的信息TRichView-23.1-XE7-D12 Lazarus FS.7z这个包名里其实写得很清楚23.1是TRichView的产品版本号对应2023年的第一个主版本和Delphi的10.x、11.x、12.x并不直接挂钩。XE7-D12表示支持从RAD Studio XE7一直到Delphi 12 Athens的版本范围。所谓D12就是Delphi 12Delphi 12之前还有11.3、11.2等小版本。Lazarus FS表示同时提供了Lazarus/Free Pascal专用版本。这里的FS多半是指Free Pascal源代码兼容版用来区分VCL和LCL不同的API实现。拿到这类安装包后先别急着双击某个.dpk应该先确认包内是否按IDE版本划分了目录。我解压后看到的是Source、Packages、Demos、Docs这样的标准结构其中Packages下面有按Delphi版本命名的子目录比如Delphi12、Delphi11、Lazarus等。如果你的包比较古老可能是所有版本共用一份源码但编译参数不同。1.3 为什么跨IDE兼容性重要很多团队同时维护Delphi老项目和Lazarus新项目比如老代码在Delphi XE7上跑着新模块因为授权或跨平台需求迁移到Lazarus。TRichView的API在VCL和LCL里高度一致大多数RTL层的操作比如AddText、InsertPicture、SaveRVF等几乎不用改就能在两边编译。这意味着你可以把同一套业务编辑界面从Delphi迁移到Lazarus减少大量重复开发。但要注意“API一致”不等于“安装方式一致”。Delphi用.dpk编译bpl包Lazarus用.lpk编译lpk包两者不能混用。不少人在Lazarus里直接试图打开Delphi的.dpk结果提示格式不支持。这个包同时提供了Delphi和Lazarus两套包文件正是为了避开这个坑所以安装前一定先分清楚自己用的是哪个IDE。2. 安装前的准备工作2.1 解压与目录规划TRichView-23.1-XE7-D12 Lazarus FS.7z是7z格式需要用7-Zip解压。建议解压到路径无中文、无空格的目录比如D:\Components\TRichView-23.1。很多IDE的BPL和DCU查找机制对路径空格很敏感尤其是Lazarus和跨平台编译一旦把组件放在C:\Users\张三\My Components这种目录后面大概率会踩到“找不到单元”的报错。解压后先看README或Install文档。不同版本号的TRichView对安装步骤有差异有的需要先编译RichView.pas有的包文件已经做了依赖编排。我一般会顺便检查一下是否有Demos目录它非常有价值里面包含了大量示例代码比官方PDF文档直观得多安装完以后留着当参考。2.2 备份现有组件和IDE环境安装新版本前先把IDE里已经存在的TRichView相关包卸载掉。怎么判断有没有旧版打开Delphi的Component Install Packages搜索列表里的RichView或TRichView关键字。如果有先把勾选去掉或者在Package窗口中右键Uninstall。这一步不能偷懒。我见过有人直接把新版本解压后覆盖到旧版本目录然后打开IDE所有用到TRichView的窗体全部报错甚至IDE直接崩溃。原因是旧版的BPL和DCP文件还残留在系统里新包编译出来的文件名如果相同会和新版文件产生冲突。稳妥的做法是先备份旧目录再卸载旧Package再装新版。2.3 确认IDE版本和包文件对应关系每个小的IDE版本对编译器版本号都不同比如Delphi 11的编译器是dcc32.exe的35.0版本Delphi 12是36.0而XE7是30.0。TRichView的包文件通常会按编译器版本命名或放在不同的子目录比如可能叫RichView_35.dpk、RichView_36.dpk。你需要打开Help About确认你的Delphi精确版本再选择对应的包。Lazarus这边则要确认FPC版本。打开Help About能看到Lazarus的版本和FPC版本比如Lazarus 3.0配FPC 3.2.2。不同FPC版本对接口和内存管理有差异如果包是按FPC版本划分的选错版本编译时会出现大量类型不兼容报错。好在TRichView的FS包一般兼容性做得不错但还是要先看清文件夹名称。3. 在Delphi中安装TRichView 23.1的完整流程3.1 编译运行时包和设计时包先用Delphi打开对应的运行时包文件通常叫RichView_Runtime.dpk或类似名称。在Package窗口里右键选择Compile先让运行时包编译通过。如果没有报错接下来打开设计时包比如RichView_Design.dpk右键选择Install。设计时包安装成功后会弹出提示框告诉你已注册到IDE。这里有个容易忽略的点如果直接把设计时包打开并Install它其实会隐式依赖运行时包所以严格来说先编译运行时包再Install设计时包是最稳的顺序。某些版本还包含第三方可选依赖比如RV_My.pas之类如果编译报告缺少特定单元多半是依赖包的路径没配好可以先跳过不装。3.2 配置Library Path安装成功后组件面板一般能直接拖出TRichViewEdit。但如果你新建了一个工程编译时却提示Unit RichView not found那就说明Library Path没有配置好。打开Tools Options Language Delphi Library在Library path里加入TRichView的Source目录。注意64位平台要用Library path中的64位路径老项目的32位编译则用32位路径。我通常会把源目录同时加到两份路径里避免来回切换平台时少一个。这里有个细节如果你用的是包内已经编译好的.dcu路径要指向包含.dcu的文件夹如果是源码安装路径指向.pas所在目录。强烈建议用源码方式安装方便以后调试进入控件内部看实现逻辑也方便自己改一些跟业务耦合的代码。3.3 验证安装并写个最小例子组件面板出现TRichViewEdit后我习惯立即新建一个VCL Application放一个TRichViewEdit和一个按钮写几行代码验证procedure TForm1.FormCreate(Sender: TObject); begin RichViewEdit1.Clear; RichViewEdit1.AddText(Hello TRichView, 0, 12); end;运行后如果能看到Hello TRichView说明基本安装没问题。接着可以测试一下输入中文、设置字体颜色、插入图片确认没有异常退出。Delphi 12有时组件面板刷新不及时安装后如果找不到控件先关闭IDE重新打开不要急着反复Install那只会产生一堆重复包记录。4. 在Lazarus/Free Pascal中安装FS版本4.1 用Package窗口编译安装打开Lazarus菜单Package Open Package File在包目录里找到.lpk文件。TRichView的FS包一般叫RichViewFS.lpk或RichView_Package.lpk。打开后Package窗口会显示包的组成单元和依赖。先点工具栏上的Compile确认编译通过。然后再点InstallLazarus会提示需要重建IDE。选择Yes等待Lazarus重新编译并重启。注意Install按钮只有在存在设计时包时才可用如果当前打开的只是运行时包你只会看到Compile按钮这时要找到设计时包再安装。4.2 配置Other Unit Files与Delphi不同Lazarus不会把组件源目录自动加进全局搜索路径。打开Project Compiler Options Paths在Other Unit Files中把TRichView的Source目录、Lazarus专用目录一并加入。如果不开这个配置即使安装成功你新建的工程还是会报找不到RichView单元。我有一个习惯在Lazarus的Environment Options Files Other Unit Files里配置一份全局路径这样以后所有工程都不用再手动添加。但要注意全局路径对跨平台交叉编译不友好比如Android编译时需要额外加LCL和WidgetSet相关路径所以具体项目里最好还是在工程级配一份避免全局配置污染。4.3 跨平台编译的小注意点Lazarus最吸引人的地方是跨平台但富文本编辑恰恰是跨平台最容易出问题的一块。比如在Windows上字体默认是Microsoft YaHei到了Linux下就变成了Noto Sans CJK行高和字符间距都会变化。TRichView虽然做了抽象但不同平台的默认字体渲染引擎不同你可能需要根据操作系统动态设置默认字体。我尝试过在Linux的Lazarus下编译同一份TRichView工程本来在Windows上排版OK的文档到Linux上表格边框变粗、图片被拉伸。后来在FormCreate里根据{$IFDEF LINUX}调整了控件的默认字体和缩放系数才基本一致。做跨平台方案时一定要提前规划这些差异不要等到最后打包才测。5. 核心功能实操从编辑器到文档处理5.1 快速搭建富文本编辑器界面一个最基本的富文本编辑器只需要一个TRichViewEdit和几个按钮。TRichViewEdit本身已经包含滚动条、光标处理、快捷键复制粘贴等基础功能不需要你再额外放一个TScrollBox。下面是我在项目里常用的一段初始化代码procedure TForm1.FormCreate(Sender: TObject); begin RichViewEdit1.Clear; RichViewEdit1.Background.Color : clWhite; RichViewEdit1.Font.Name : 宋体; RichViewEdit1.Font.Size : 11; RichViewEdit1.ParaIndent : 12; RichViewEdit1.TabWidth : 24; end;这里的ParaIndent和TabWidth会影响段落缩进和Tab键的跳格宽度对中文排版尤其重要。如果你不设置默认的段落缩进可能偏小看起来很难受。5.2 文本格式、图片和表格操作选中一段文本后可以调用SetSelectionBold、SetSelectionColor、SetSelectionFontSize等方法。这些方法都作用于当前选区如果当前没有选区则作用于光标所在位置之后的输入状态。我在给客户做报告编辑器时经常用按钮写入预设格式RichViewEdit1.SetSelectionBold(True); RichViewEdit1.SetSelectionColor(clRed); RichViewEdit1.SetSelectionFontSize(14); RichViewEdit1.SetSelectionName(黑体);插入图片可以直接用InsertPicture方法支持文件路径和流。插入表格稍微麻烦一点需要先创建TRVTable对象设置行列数再用AddTable加进文档。这里有个经验如果在插入图片之前没保存或设置了当前编辑位置图片可能会跑到文档末尾。保险做法是先定位到一个明确的书签或段落再用SetSelectionBounds之类的接口设置插入点。5.3 导入导出HTML、RTF与纯文本TRichView有一套统一的导入导出机制包括RVF、HTML、RTF、纯文本等格式。RVF是TRichView自己的私有格式保留的信息最多从格式到书签、图片、表格都能完整保存。HTML则适合Web展示但CSS支持有限RTF适合Word兼容。我常用的导出HTML代码是var html: string; begin html : RichViewEdit1.GetHTMLText; Memo1.Text : html; end;加载HTML时要注意编码问题。如果HTML声明是charsetutf-8而IDE里是ANSI直接导入会乱码。我建议用TStringStream指定编码var ms: TStringStream; html: string; begin html : Memo1.Text; ms : TStringStream.Create(html, TEncoding.UTF8); try RichViewEdit1.LoadHTMLFromStream(ms); finally ms.Free; end; end;5.4 与数据库、Excel集成很多业务系统要求把富文本内容存进数据库或者导出成Excel。直接存HTML字符串到数据库字段虽然方便但查询和展示时容易丢失格式。我会在数据库里用两个字段一个Blob字段存RVF二进制流一个Memo字段存纯文本用于列表预览和全文检索。纯文本获取很简单var plain: string; begin plain : RichViewEdit1.GetPlainText; end;拿到纯文本后可以再配合MD5算法做内容比对、缓存或者像热词里说的“用SQL select查询”检索包含关键词的记录。导出Excel时传统做法是把纯文本按制表符组装成TSV再用Delphi的ADO连接Excel写入。例如先RichViewEdit1.GetPlainText按行拆分成字符串数组再通过TADOCommand批量写入Excel。这样既保留文档主要内容又让Excel单元格里的数据可被二次统计。6. 常见问题排查与避坑记录6.1 每次进入IDE都丢失控件的经典问题这是Delphi开发者问得最多的问题也是社区里常年霸榜的话题。现象是你把TRichView安装好了昨天还能用今天打开IDE组件面板上什么都没有原来窗体上的TRichViewEdit全部变成未识别的“XXX”类保存一下再打开依然如此。排查思路按优先级来确认设计时包是否勾选在Component Install Packages里找一下TRichView相关包。检查BPL文件路径。如果BPL放在非系统目录要让IDE能找到它可以把BPL所在目录加入系统PATH或者IDE的Browse Path。查看Windows事件查看器中IDE崩溃日志看是否加载了冲突的DLL。怀疑旧版本DCP残留直接删除旧版本目录中同名.dcp文件重新编译安装。我遇到过一种隐蔽情况TRichView包和Ehlib包同时使用了同一个第三方依赖库两个包各装各的导致注册函数冲突。处理办法是调整Package加载顺序或者统一换成同一个依赖版本。6.2 Unicode编码与Delphi字符串处理TRichView从21世纪初期开始就全面转向Unicode内部字符串类型是WideString或UnicodeString和Delphi 2009之后的默认string类型是一致的。如果你还在用Delphi 7就需要用WideString来接收纯文本否则文字会被截断成ANSI。处理文档内容时记得RichViewEdit1.GetPlainText返回的已经是Unicode字符串。做MD5计算前最好统一转成UTF-8后再计算否则同一个字符串在不同系统上可能算出不同的MD5值。简单示例var bytes: TBytes; md5: string; begin bytes : TEncoding.UTF8.GetBytes(RichViewEdit1.GetPlainText); md5 : TMD5.GetHashString(Bytes); // 根据Delphi版本决定具体API end;6.3 安卓/iOS平台上的FMX与Lazarus差异现在不少项目用Delphi FireMonkey做安卓PDA和扫码枪终端TRichView在FMX下的表现和传统VCL有很大区别。FMX版本的TRichView不是简单地把VCL控件搬运过来而是基于FMX的渲染管线重新实现很多属性名、方法名都和VCL版不一样。我在PDA项目里遇到过一个问题TRichViewEdit嵌入到Form后软键盘弹出来会把编辑区域挡住。解决方法是把TRichViewEdit的滚动功能禁用只允许显示和点击外部用一个TVertScrollBox来滚动整个页面同时监听软键盘高度动态调整ScrollBox的底部空白。这个方案实测比控件自己的滚动稳很多。Lazarus在安卓上的富文本编辑则更折腾。LCL安卓组件本身对中文输入法和焦点管理支持一般我的建议是移动端尽量少用完整富文本编辑器能用纯文本就用纯文本。6.4 编译报错找不到单元的处理“Cannot find unit RichView.pas”或者“Fatal: Cant find unit RichView used by ...”这类报错几乎都是路径问题。Delphi平台检查Library PathLazarus平台检查Other Unit Files。另一个容易忽略的是如果你把整个TRichView包目录移动过旧的.dcu缓存文件还在原路径编译器会同时引用新旧路径导致冲突。此时删除编译缓存目录Delphi里是.dcuLazarus里是lib文件夹重新编译一次即可。如果报错说找不到RVStyle.pas或RVTable.pas那说明包内文件没有全量解压或者子目录没有被加入搜索路径。TRichView的单元分散在多个子目录比如Source、Source\RV、Source\Tables等别只加顶层目录。7. 个人使用心得与进阶建议7.1 用RVF作为内部文档格式我在多个项目中踩过坑最后一致推荐把RVF作为内部存储格式。RVF是TRichView的原生格式保存的是完整文档对象包括段落、字符、图片、表格、书签、超链接加载速度远快于RTF转HTML体积也小。保存到数据库时可以把RVF内容写入TMemoryStream再存入Blob字段读取时反向操作。这样既不容易丢失格式也方便版本升级。如果项目刚开始用的是RTF存储建议尽早写个迁移工具把RTF批量转成RVF否则信息越攒越多后面转格式的代价会成倍增长。7.2 封装层设计减少迁移成本TRichView的接口在每次升级中都有可能变化尤其从VCL跨到FMX、从Delphi跨到Lazarus时不可能完全兼容。我建议在业务代码和控件之间加一个接口层把加载、保存、设置格式、插入图片等操作封装成自己的函数。比如我封装了一个TDocumentController类外部只调用LoadFromDB、SaveToDB、SetBold、InsertSignature等接口业务层完全不直接触碰TRichViewEdit。后来项目从Delphi迁到Lazarus我只改了TDocumentController内部的实现业务代码几乎没有动。这个设计也方便你随时替换底层控件比如未来团队决定换另一个富文本方案时不至于全盘重写。7.3 从老版本迁移和高版本新特性如果你还在用Delphi 7时代的TRichView升级到23.1要注意几个大的变化最明显的是字符串类型从String变成了WideString很多老代码需要统一调整其次是控件属性名有改动比如OnCurrChange、OnRVDrawItem等事件签名变了再就是Style体系从TRVStyle对象变成了全局的RVStyle单例。23.1版本在高DPI和触摸屏上的表现好了很多。我在4K分辨率的Windows平板上测试字体和工具栏图标缩放正常不会出现以前那种一个控件在低分辨率上做好、拉到高分屏就糊掉的情况。这点对现代桌面应用很关键。如果你有老项目要升级建议先跑一遍官方Demo里的Misc目录里面有迁移相关的说明和示例。最后再分享一个小技巧安装完TRichView后千万别把Demos目录删了。里面不仅有几乎全部功能的示例代码还有RichViewActions、RichViewEdit和纯RichView三种模式的对比。遇到属性搞不定时直接搜Demo源码比翻文档快得多。本文还有配套的精品资源点击获取
TRichView 23.1跨IDE安装实战：Delphi 12与Lazarus避坑指南
简介富文本编辑是桌面应用开发中的常见需求TRichView作为Delphi/CBuilder/Lazarus生态下的专业控件提供了完整的文档对象模型和丰富的编辑功能。本文从富文本控件的基本概念出发解析TRichView 23.1版本包中XE7-D12与Lazarus FS的版本兼容性原理说明其在VCL与LCL间API一致而安装方式不同的技术要点。结合工程实践给出在Delphi 12和Lazarus中编译安装、配置Library Path/Other Unit Files、验证最小例程的完整步骤并针对IDE崩溃、控件丢失、编码乱码、跨平台差异等高频问题提供排查思路。无论你是RichView新手还是老项目升级掌握这些方法都能有效减少踩坑快速构建稳定的富文本编辑功能。 这几天在整理组件目录时翻出一个TRichView-23.1-XE7-D12 Lazarus FS.7z安装包刚好手头Delphi 12和Lazarus两头跑就顺手把两个IDE里的富文本编辑需求都切到了这个版本上。TRichView是我这些年用下来在Delphi/Lazarus体系里最省心的富文本控件之一但这个包涉及XE7到D12、还有Lazarus FS版本不看清楚很容易装错装完又会出现各种IDE崩溃、控件丢失的问题。这篇文章就把拆包、安装、踩坑和常见用法一次说清楚。1. 项目背景与版本兼容性解析1.1 TRichView是什么解决什么问题TRichView是一套专门给Delphi、CBuilder以及Lazarus使用的第三方富文本编辑控件核心目标是在你的程序里实现“类WordPad”的所见即所得编辑能力。它不只支持简单的加粗、斜体、字体颜色还能处理图片、表格、列表、超链接、段落编号、多级撤销重做这些功能如果完全用原生TEdit、TMemo去堆开发量会非常恐怖。我第一次接触这个控件是在做一个通用报告编辑工具时需求是把数据库里查出来的结构化数据动态生成一份带格式的Word风格文档。用TMemo做原型光是处理图片和表格就写了三周后来换成TRichView不到两天就把核心功能跑通了。它最核心的价值是提供了完整的文档对象模型你不需要维护一套自己的“文本格式”数据结构直接操作控件内部文档就能实现加载、保存、编辑、打印全流程。1.2 版本号里藏着的信息TRichView-23.1-XE7-D12 Lazarus FS.7z这个包名里其实写得很清楚23.1是TRichView的产品版本号对应2023年的第一个主版本和Delphi的10.x、11.x、12.x并不直接挂钩。XE7-D12表示支持从RAD Studio XE7一直到Delphi 12 Athens的版本范围。所谓D12就是Delphi 12Delphi 12之前还有11.3、11.2等小版本。Lazarus FS表示同时提供了Lazarus/Free Pascal专用版本。这里的FS多半是指Free Pascal源代码兼容版用来区分VCL和LCL不同的API实现。拿到这类安装包后先别急着双击某个.dpk应该先确认包内是否按IDE版本划分了目录。我解压后看到的是Source、Packages、Demos、Docs这样的标准结构其中Packages下面有按Delphi版本命名的子目录比如Delphi12、Delphi11、Lazarus等。如果你的包比较古老可能是所有版本共用一份源码但编译参数不同。1.3 为什么跨IDE兼容性重要很多团队同时维护Delphi老项目和Lazarus新项目比如老代码在Delphi XE7上跑着新模块因为授权或跨平台需求迁移到Lazarus。TRichView的API在VCL和LCL里高度一致大多数RTL层的操作比如AddText、InsertPicture、SaveRVF等几乎不用改就能在两边编译。这意味着你可以把同一套业务编辑界面从Delphi迁移到Lazarus减少大量重复开发。但要注意“API一致”不等于“安装方式一致”。Delphi用.dpk编译bpl包Lazarus用.lpk编译lpk包两者不能混用。不少人在Lazarus里直接试图打开Delphi的.dpk结果提示格式不支持。这个包同时提供了Delphi和Lazarus两套包文件正是为了避开这个坑所以安装前一定先分清楚自己用的是哪个IDE。2. 安装前的准备工作2.1 解压与目录规划TRichView-23.1-XE7-D12 Lazarus FS.7z是7z格式需要用7-Zip解压。建议解压到路径无中文、无空格的目录比如D:\Components\TRichView-23.1。很多IDE的BPL和DCU查找机制对路径空格很敏感尤其是Lazarus和跨平台编译一旦把组件放在C:\Users\张三\My Components这种目录后面大概率会踩到“找不到单元”的报错。解压后先看README或Install文档。不同版本号的TRichView对安装步骤有差异有的需要先编译RichView.pas有的包文件已经做了依赖编排。我一般会顺便检查一下是否有Demos目录它非常有价值里面包含了大量示例代码比官方PDF文档直观得多安装完以后留着当参考。2.2 备份现有组件和IDE环境安装新版本前先把IDE里已经存在的TRichView相关包卸载掉。怎么判断有没有旧版打开Delphi的Component Install Packages搜索列表里的RichView或TRichView关键字。如果有先把勾选去掉或者在Package窗口中右键Uninstall。这一步不能偷懒。我见过有人直接把新版本解压后覆盖到旧版本目录然后打开IDE所有用到TRichView的窗体全部报错甚至IDE直接崩溃。原因是旧版的BPL和DCP文件还残留在系统里新包编译出来的文件名如果相同会和新版文件产生冲突。稳妥的做法是先备份旧目录再卸载旧Package再装新版。2.3 确认IDE版本和包文件对应关系每个小的IDE版本对编译器版本号都不同比如Delphi 11的编译器是dcc32.exe的35.0版本Delphi 12是36.0而XE7是30.0。TRichView的包文件通常会按编译器版本命名或放在不同的子目录比如可能叫RichView_35.dpk、RichView_36.dpk。你需要打开Help About确认你的Delphi精确版本再选择对应的包。Lazarus这边则要确认FPC版本。打开Help About能看到Lazarus的版本和FPC版本比如Lazarus 3.0配FPC 3.2.2。不同FPC版本对接口和内存管理有差异如果包是按FPC版本划分的选错版本编译时会出现大量类型不兼容报错。好在TRichView的FS包一般兼容性做得不错但还是要先看清文件夹名称。3. 在Delphi中安装TRichView 23.1的完整流程3.1 编译运行时包和设计时包先用Delphi打开对应的运行时包文件通常叫RichView_Runtime.dpk或类似名称。在Package窗口里右键选择Compile先让运行时包编译通过。如果没有报错接下来打开设计时包比如RichView_Design.dpk右键选择Install。设计时包安装成功后会弹出提示框告诉你已注册到IDE。这里有个容易忽略的点如果直接把设计时包打开并Install它其实会隐式依赖运行时包所以严格来说先编译运行时包再Install设计时包是最稳的顺序。某些版本还包含第三方可选依赖比如RV_My.pas之类如果编译报告缺少特定单元多半是依赖包的路径没配好可以先跳过不装。3.2 配置Library Path安装成功后组件面板一般能直接拖出TRichViewEdit。但如果你新建了一个工程编译时却提示Unit RichView not found那就说明Library Path没有配置好。打开Tools Options Language Delphi Library在Library path里加入TRichView的Source目录。注意64位平台要用Library path中的64位路径老项目的32位编译则用32位路径。我通常会把源目录同时加到两份路径里避免来回切换平台时少一个。这里有个细节如果你用的是包内已经编译好的.dcu路径要指向包含.dcu的文件夹如果是源码安装路径指向.pas所在目录。强烈建议用源码方式安装方便以后调试进入控件内部看实现逻辑也方便自己改一些跟业务耦合的代码。3.3 验证安装并写个最小例子组件面板出现TRichViewEdit后我习惯立即新建一个VCL Application放一个TRichViewEdit和一个按钮写几行代码验证procedure TForm1.FormCreate(Sender: TObject); begin RichViewEdit1.Clear; RichViewEdit1.AddText(Hello TRichView, 0, 12); end;运行后如果能看到Hello TRichView说明基本安装没问题。接着可以测试一下输入中文、设置字体颜色、插入图片确认没有异常退出。Delphi 12有时组件面板刷新不及时安装后如果找不到控件先关闭IDE重新打开不要急着反复Install那只会产生一堆重复包记录。4. 在Lazarus/Free Pascal中安装FS版本4.1 用Package窗口编译安装打开Lazarus菜单Package Open Package File在包目录里找到.lpk文件。TRichView的FS包一般叫RichViewFS.lpk或RichView_Package.lpk。打开后Package窗口会显示包的组成单元和依赖。先点工具栏上的Compile确认编译通过。然后再点InstallLazarus会提示需要重建IDE。选择Yes等待Lazarus重新编译并重启。注意Install按钮只有在存在设计时包时才可用如果当前打开的只是运行时包你只会看到Compile按钮这时要找到设计时包再安装。4.2 配置Other Unit Files与Delphi不同Lazarus不会把组件源目录自动加进全局搜索路径。打开Project Compiler Options Paths在Other Unit Files中把TRichView的Source目录、Lazarus专用目录一并加入。如果不开这个配置即使安装成功你新建的工程还是会报找不到RichView单元。我有一个习惯在Lazarus的Environment Options Files Other Unit Files里配置一份全局路径这样以后所有工程都不用再手动添加。但要注意全局路径对跨平台交叉编译不友好比如Android编译时需要额外加LCL和WidgetSet相关路径所以具体项目里最好还是在工程级配一份避免全局配置污染。4.3 跨平台编译的小注意点Lazarus最吸引人的地方是跨平台但富文本编辑恰恰是跨平台最容易出问题的一块。比如在Windows上字体默认是Microsoft YaHei到了Linux下就变成了Noto Sans CJK行高和字符间距都会变化。TRichView虽然做了抽象但不同平台的默认字体渲染引擎不同你可能需要根据操作系统动态设置默认字体。我尝试过在Linux的Lazarus下编译同一份TRichView工程本来在Windows上排版OK的文档到Linux上表格边框变粗、图片被拉伸。后来在FormCreate里根据{$IFDEF LINUX}调整了控件的默认字体和缩放系数才基本一致。做跨平台方案时一定要提前规划这些差异不要等到最后打包才测。5. 核心功能实操从编辑器到文档处理5.1 快速搭建富文本编辑器界面一个最基本的富文本编辑器只需要一个TRichViewEdit和几个按钮。TRichViewEdit本身已经包含滚动条、光标处理、快捷键复制粘贴等基础功能不需要你再额外放一个TScrollBox。下面是我在项目里常用的一段初始化代码procedure TForm1.FormCreate(Sender: TObject); begin RichViewEdit1.Clear; RichViewEdit1.Background.Color : clWhite; RichViewEdit1.Font.Name : 宋体; RichViewEdit1.Font.Size : 11; RichViewEdit1.ParaIndent : 12; RichViewEdit1.TabWidth : 24; end;这里的ParaIndent和TabWidth会影响段落缩进和Tab键的跳格宽度对中文排版尤其重要。如果你不设置默认的段落缩进可能偏小看起来很难受。5.2 文本格式、图片和表格操作选中一段文本后可以调用SetSelectionBold、SetSelectionColor、SetSelectionFontSize等方法。这些方法都作用于当前选区如果当前没有选区则作用于光标所在位置之后的输入状态。我在给客户做报告编辑器时经常用按钮写入预设格式RichViewEdit1.SetSelectionBold(True); RichViewEdit1.SetSelectionColor(clRed); RichViewEdit1.SetSelectionFontSize(14); RichViewEdit1.SetSelectionName(黑体);插入图片可以直接用InsertPicture方法支持文件路径和流。插入表格稍微麻烦一点需要先创建TRVTable对象设置行列数再用AddTable加进文档。这里有个经验如果在插入图片之前没保存或设置了当前编辑位置图片可能会跑到文档末尾。保险做法是先定位到一个明确的书签或段落再用SetSelectionBounds之类的接口设置插入点。5.3 导入导出HTML、RTF与纯文本TRichView有一套统一的导入导出机制包括RVF、HTML、RTF、纯文本等格式。RVF是TRichView自己的私有格式保留的信息最多从格式到书签、图片、表格都能完整保存。HTML则适合Web展示但CSS支持有限RTF适合Word兼容。我常用的导出HTML代码是var html: string; begin html : RichViewEdit1.GetHTMLText; Memo1.Text : html; end;加载HTML时要注意编码问题。如果HTML声明是charsetutf-8而IDE里是ANSI直接导入会乱码。我建议用TStringStream指定编码var ms: TStringStream; html: string; begin html : Memo1.Text; ms : TStringStream.Create(html, TEncoding.UTF8); try RichViewEdit1.LoadHTMLFromStream(ms); finally ms.Free; end; end;5.4 与数据库、Excel集成很多业务系统要求把富文本内容存进数据库或者导出成Excel。直接存HTML字符串到数据库字段虽然方便但查询和展示时容易丢失格式。我会在数据库里用两个字段一个Blob字段存RVF二进制流一个Memo字段存纯文本用于列表预览和全文检索。纯文本获取很简单var plain: string; begin plain : RichViewEdit1.GetPlainText; end;拿到纯文本后可以再配合MD5算法做内容比对、缓存或者像热词里说的“用SQL select查询”检索包含关键词的记录。导出Excel时传统做法是把纯文本按制表符组装成TSV再用Delphi的ADO连接Excel写入。例如先RichViewEdit1.GetPlainText按行拆分成字符串数组再通过TADOCommand批量写入Excel。这样既保留文档主要内容又让Excel单元格里的数据可被二次统计。6. 常见问题排查与避坑记录6.1 每次进入IDE都丢失控件的经典问题这是Delphi开发者问得最多的问题也是社区里常年霸榜的话题。现象是你把TRichView安装好了昨天还能用今天打开IDE组件面板上什么都没有原来窗体上的TRichViewEdit全部变成未识别的“XXX”类保存一下再打开依然如此。排查思路按优先级来确认设计时包是否勾选在Component Install Packages里找一下TRichView相关包。检查BPL文件路径。如果BPL放在非系统目录要让IDE能找到它可以把BPL所在目录加入系统PATH或者IDE的Browse Path。查看Windows事件查看器中IDE崩溃日志看是否加载了冲突的DLL。怀疑旧版本DCP残留直接删除旧版本目录中同名.dcp文件重新编译安装。我遇到过一种隐蔽情况TRichView包和Ehlib包同时使用了同一个第三方依赖库两个包各装各的导致注册函数冲突。处理办法是调整Package加载顺序或者统一换成同一个依赖版本。6.2 Unicode编码与Delphi字符串处理TRichView从21世纪初期开始就全面转向Unicode内部字符串类型是WideString或UnicodeString和Delphi 2009之后的默认string类型是一致的。如果你还在用Delphi 7就需要用WideString来接收纯文本否则文字会被截断成ANSI。处理文档内容时记得RichViewEdit1.GetPlainText返回的已经是Unicode字符串。做MD5计算前最好统一转成UTF-8后再计算否则同一个字符串在不同系统上可能算出不同的MD5值。简单示例var bytes: TBytes; md5: string; begin bytes : TEncoding.UTF8.GetBytes(RichViewEdit1.GetPlainText); md5 : TMD5.GetHashString(Bytes); // 根据Delphi版本决定具体API end;6.3 安卓/iOS平台上的FMX与Lazarus差异现在不少项目用Delphi FireMonkey做安卓PDA和扫码枪终端TRichView在FMX下的表现和传统VCL有很大区别。FMX版本的TRichView不是简单地把VCL控件搬运过来而是基于FMX的渲染管线重新实现很多属性名、方法名都和VCL版不一样。我在PDA项目里遇到过一个问题TRichViewEdit嵌入到Form后软键盘弹出来会把编辑区域挡住。解决方法是把TRichViewEdit的滚动功能禁用只允许显示和点击外部用一个TVertScrollBox来滚动整个页面同时监听软键盘高度动态调整ScrollBox的底部空白。这个方案实测比控件自己的滚动稳很多。Lazarus在安卓上的富文本编辑则更折腾。LCL安卓组件本身对中文输入法和焦点管理支持一般我的建议是移动端尽量少用完整富文本编辑器能用纯文本就用纯文本。6.4 编译报错找不到单元的处理“Cannot find unit RichView.pas”或者“Fatal: Cant find unit RichView used by ...”这类报错几乎都是路径问题。Delphi平台检查Library PathLazarus平台检查Other Unit Files。另一个容易忽略的是如果你把整个TRichView包目录移动过旧的.dcu缓存文件还在原路径编译器会同时引用新旧路径导致冲突。此时删除编译缓存目录Delphi里是.dcuLazarus里是lib文件夹重新编译一次即可。如果报错说找不到RVStyle.pas或RVTable.pas那说明包内文件没有全量解压或者子目录没有被加入搜索路径。TRichView的单元分散在多个子目录比如Source、Source\RV、Source\Tables等别只加顶层目录。7. 个人使用心得与进阶建议7.1 用RVF作为内部文档格式我在多个项目中踩过坑最后一致推荐把RVF作为内部存储格式。RVF是TRichView的原生格式保存的是完整文档对象包括段落、字符、图片、表格、书签、超链接加载速度远快于RTF转HTML体积也小。保存到数据库时可以把RVF内容写入TMemoryStream再存入Blob字段读取时反向操作。这样既不容易丢失格式也方便版本升级。如果项目刚开始用的是RTF存储建议尽早写个迁移工具把RTF批量转成RVF否则信息越攒越多后面转格式的代价会成倍增长。7.2 封装层设计减少迁移成本TRichView的接口在每次升级中都有可能变化尤其从VCL跨到FMX、从Delphi跨到Lazarus时不可能完全兼容。我建议在业务代码和控件之间加一个接口层把加载、保存、设置格式、插入图片等操作封装成自己的函数。比如我封装了一个TDocumentController类外部只调用LoadFromDB、SaveToDB、SetBold、InsertSignature等接口业务层完全不直接触碰TRichViewEdit。后来项目从Delphi迁到Lazarus我只改了TDocumentController内部的实现业务代码几乎没有动。这个设计也方便你随时替换底层控件比如未来团队决定换另一个富文本方案时不至于全盘重写。7.3 从老版本迁移和高版本新特性如果你还在用Delphi 7时代的TRichView升级到23.1要注意几个大的变化最明显的是字符串类型从String变成了WideString很多老代码需要统一调整其次是控件属性名有改动比如OnCurrChange、OnRVDrawItem等事件签名变了再就是Style体系从TRVStyle对象变成了全局的RVStyle单例。23.1版本在高DPI和触摸屏上的表现好了很多。我在4K分辨率的Windows平板上测试字体和工具栏图标缩放正常不会出现以前那种一个控件在低分辨率上做好、拉到高分屏就糊掉的情况。这点对现代桌面应用很关键。如果你有老项目要升级建议先跑一遍官方Demo里的Misc目录里面有迁移相关的说明和示例。最后再分享一个小技巧安装完TRichView后千万别把Demos目录删了。里面不仅有几乎全部功能的示例代码还有RichViewActions、RichViewEdit和纯RichView三种模式的对比。遇到属性搞不定时直接搜Demo源码比翻文档快得多。本文还有配套的精品资源点击获取
