简介：Raize Components 6.1.1.12（DX10.1 Berlin）修正版面向仍在使用 Delphi/C++Builder Berlin 的桌面应用开发者，主要解决原版 Pascal 源文件存在语法错误、组件包难以顺利编译的问题，也适合维护旧项目或研究经典控件实现的读者。压缩包共 956 个文件，约 10.74MB，以 202 个 hpp、198 个 dcu、114 个 pas 和 183 个 bmp 为主，分别对应 C++ 头文件、预编译单元、Pascal 源码与界面图像素材；同时含有 dfm 窗体资源、dpk 与 dproj 包工程、res 资源及构建脚本，目录按源码、资源、包工程分区，检索和比对较为方便。包内附带安装说明与已调整的配置文件，并修正了会导致编译失败的 pas 错误，可帮助读者减少环境配置和排错时间，快速理解组件包的组织方式与依赖关系。该版本保留完整设计期控件、运行时包与示例图像，便于对照组件声明与资源引用。目前已有 330 人学习下载，适合需要复用界面控件、补齐旧版编译链或进行源码级研究的开发者参考。
1. 从一次编译报错说起：Raize 6.1.1.12 在 Berlin 下的真实安装门槛
上周帮一个朋友处理他维护了七年的老项目，Delphi 10.1 Berlin 环境，打开工程就弹出一串Unit 'RzCommon' not found。项目里几十个窗体依赖 Raize 控件，源码在，但设计期包怎么也装不上。官方原版安装包在 Berlin 上跑一半就报编译错误，换了两台机器都一样。后来翻到一个修正版资源——Raize_6.1.1.12_DX10_1_Berlin_cocashu修正版，才把环境恢复。这个包本质上是 Raize Components 6.1.1.12 针对 DX10.1 Berlin 的适配补丁，解决官方包因 IDE 内部单元变动导致的编译失败和设计期注册异常。它适合两类人：一是维护老 Delphi 项目、必须用回 Raize 控件库的开发者；二是刚从旧版 IDE 迁移到 Berlin、需要一套能用控件包的团队。安装过程不算复杂，但版本对位和包编译顺序错了就会卡在“包已加载但控件不出现”的玄学状态。
2. 拆包与版本对位：先确认你的 IDE 和 Raize 版本锁死
2.1 为什么 DX10.1 Berlin 需要专用修正版
Raize Components 6.1.1.12 官方发布的时候，主要适配的是 Delphi 10 Seattle 和更早版本。Berlin 虽然同属 10.x 系列，但 IDE 内部的一些单元接口和包结构发生了变化，尤其是设计期包依赖的DesignIntf、DesignEditors等单元在 Berlin 里增加了新的方法声明。官方安装包里的预编译包和源码在 Berlin 下编译时，会遇到两类典型错误：一类是E2003 Undeclared identifier，指向某些设计期单元的新增方法；另一类是F2613 Unit 'Rz...' not found，因为包引用路径里还带着旧版 IDE 的目录结构。修正版做的事情并不神秘——它调整了包项目的引用路径，修补了源码里与 Berlin 不兼容的条件编译分支，并且重新组织了安装脚本的搜索顺序。所以你不能拿一个 Seattle 版本的 Raize 包硬塞进 Berlin，即使强行编译通过，设计期控件注册也可能失败。常见做法是先确认 IDE 的完整版本号：在 Berlin 的 IDE 里点Help→About，看版本号是否为 24.0.22858.6822 这类 24.0 开头的编号。Raize 6.1.1.12 修正版的目录名里带DX10_1，就是专门给这个版本用的。如果你用的是 Delphi 10.2 Tokyo 或更高版本，这个包不适合直接套用，需要找对应版本的 Raize 修正包。版本锁死这件事没有后悔药，装之前花两分钟核对，比装完再卸载干净得多。
我一般会先检查系统里是否残留旧版 Raize 的包。Berlin 的 IDE 里，如果之前装过官方版但没卸载干净，组件面板上可能还留着半套控件，这时候再装修正版就会出现两个同名包竞争。正确的清理顺序是：打开 IDE 的Component→Install Packages，在列表里找到所有名字带Raize的设计期包，逐个选中并点Remove，注意不要勾选“Delete files from disk”，只从 IDE 注销。然后关闭 IDE，去注册表里搜Raize关键字，把HKEY_CURRENT_USER\Software\Embarcadero\BDS\18.0\Known Packages下面残留的 Raize 路径项删掉。这一步很多人会跳过，结果修正版装完后控件面板出现重复项，或者编译时提示包版本冲突。清理完再解压修正包，能避开一半的玄学问题。
2.2 解压后先看这三个目录：Source、Packages、Bin
修正版解压后的根目录通常包含Source、Packages、Bin、Demos等文件夹。别急着双击任何 exe 或 bat，先花几分钟把目录结构摸清楚。Source里是全部控件的 Pascal 源码，按功能分成RzCommon、RzEdit、RzGrids等子目录，每个子目录下都有对应的.pas文件。Packages里存放的是包项目文件，Delphi 的包项目后缀是.dproj，运行期包通常叫RaizeComponentsVcl.dproj，设计期包叫RaizeComponentsVcl_D.dproj或类似名字。Bin目录里可能会有预编译的.bpl和.dcp文件，但修正版为了兼容 Berlin，一般建议从源码重新编译，不要直接使用预编译文件，因为预编译文件可能是在不同补丁级别的 IDE 下生成的。Demos里是示例工程，可以用来验证安装是否成功，但不要一上来就编译 Demo，先把包装好。
这里有一个细节容易被忽略：修正版的Source目录里可能包含一个Raize.inc或RzConfig.inc这样的配置文件，里面定义了条件编译开关，比如RAIZE_DX10_1或者RAIZE_HDPI。你需要确认这个文件里的开关与你的 IDE 版本匹配。有些修正版会把这个判断放在安装脚本里自动完成，但手动编译时如果开关不对，就会出现“编译通过但控件行为异常”的情况。我一般会打开这个 inc 文件看一眼，确保DX10_1相关的定义是打开的，而不是被注释掉。另外，Packages目录下可能还有Win32和Win64两个子目录，分别存放不同平台的包项目。Berlin 默认编译 Win32 包，如果你的项目需要 Win64，就要在安装完 Win32 设计期包之后，单独编译 Win64 运行期包，并把它加入库路径。不要想着一个包通吃两个平台，Delphi 的包是按平台分开的。
提示：解压路径里不要带中文或空格，比如
D:\工作\Raize修正版这种路径在 msbuild 编译时容易因为编码问题报错。我习惯解压到D:\Components\Raize_6.1.1.12_Berlin，纯英文、无空格，后续命令行操作也省心。
3. 编译与安装全流程：从 msbuild 命令行到设计期包注册
3.1 用 msbuild 编译运行期包
虽然可以在 IDE 里打开包项目手动编译，但用 msbuild 命令行更可控，尤其是需要反复重装或者批量部署的时候。Berlin 自带的 msbuild 路径通常在C:\Program Files (x86)\Embarcadero\Studio\18.0\bin下面，但更稳妥的方式是使用 RAD Studio 提供的rsvars.bat来初始化环境变量。打开命令行，先执行rsvars.bat，然后切换到修正版的Packages\Win32目录，用 msbuild 编译运行期包。下面这段命令是我常用的模板，路径根据实际解压位置调整：
# 先初始化 Delphi 编译环境，路径按你的 Berlin 安装位置改 call "C:\Program Files (x86)\Embarcadero\Studio\18.0\bin\rsvars.bat" # 进入修正版的 Win32 包目录 cd /d D:\Components\Raize_6.1.1.12_Berlin\Packages\Win32 # 编译运行期包，Release 配置，Win32 平台 msbuild RaizeComponentsVcl.dproj /p:Config=Release /p:Platform=Win32 /t:Build /v:minimal这段命令里，rsvars.bat的作用是把bds、msbuild等工具加入 PATH，并设置BDS环境变量，这样 msbuild 才能找到 Delphi 的编译器和库路径。/p:Config=Release指定编译 Release 版本，减少调试信息，包体积也小一些；/p:Platform=Win32明确平台，避免默认平台不对导致编译失败；/t:Build表示执行完整构建，而不是增量编译；/v:minimal把输出精简到只显示警告和错误，方便看关键信息。如果编译成功，会在Packages\Win32\下生成RaizeComponentsVcl.bpl和RaizeComponentsVcl.dcp等文件。注意看输出里有没有警告字样，有些警告是修正版为了兼容 Berlin 故意保留的，不影响使用，但如果是错误，就要停下来看具体是哪个单元报错。
编译运行期包时最常见的失败原因是库路径里缺少 Raize 的 Source 目录。msbuild 编译包项目时，会按照.dproj里定义的搜索路径去找单元，如果修正版的包项目里写的是相对路径，而你的解压位置和它预期的相对关系不一致，就会报F1026 File not found: 'RzCommon.pas'。解决办法有两个：一是在编译前手动把Source目录加到系统环境变量BDSLIB或者 IDE 的库路径里；二是直接用 msbuild 的/p:IncludePath参数追加路径。我一般用第二种，命令行里一次写清楚，不污染全局环境：
msbuild RaizeComponentsVcl.dproj /p:Config=Release /p:Platform=Win32 /t:Build ^ /p:IncludePath="D:\Components\Raize_6.1.1.12_Berlin\Source;$(IncludePath)"这里^是 Windows 命令行的续行符，$(IncludePath)保留原有的搜索路径，把 Raize 的 Source 目录插到最前面。这样编译时优先从修正版源码里找单元，避免误用系统里残留的旧版 Raize 单元。编译完运行期包之后，先别急着装设计期包，打开Packages\Win32目录确认生成的.bpl文件时间戳是刚才的，避免编译输出到了别的目录。
3.2 在 IDE 中安装设计期包并配置库路径
运行期包编译成功后，就可以安装设计期包了。设计期包的项目文件通常叫RaizeComponentsVcl_D.dproj，同样在Packages\Win32目录下。你可以继续用 msbuild 编译它，但设计期包的注册动作必须在 IDE 里完成，因为需要把控件注册到组件面板。步骤是：打开 Berlin IDE，点Component→Install Packages，在弹出的对话框里点Add，浏览到Packages\Win32\RaizeComponentsVcl_D.bpl（如果还没编译，就先在 IDE 里打开RaizeComponentsVcl_D.dproj点 Build）。选中后点OK，IDE 会加载设计期包。如果加载成功，组件面板上会出现一个Raize标签页，里面排列着RzButton、RzEdit、RzGrid等控件。
但很多时候第一次加载会弹窗报错，提示Cannot load package 'RaizeComponentsVcl_D'或者The specified module could not be found。这通常是因为设计期包依赖运行期包，而运行期包的路径没有加入 IDE 的包搜索路径。Berlin 的 IDE 里，包搜索路径在Tools→Options→Environment Options→Delphi Options→Library里设置，分为Library path和Browsing path。你需要把Packages\Win32目录加到Library path的最前面，同时把Source目录也加进去。注意Library path是分平台的，Win32 和 Win64 要分别配置。配置完点OK保存，最好重启一次 IDE，让路径生效。重启后再去Install Packages里添加设计期包，成功率会高很多。
安装成功后，还有一步不能漏：把 Raize 的 Source 路径和包输出路径固化到 IDE 的库路径里，否则以后新建工程引用 Raize 控件时，编译器找不到.dcu文件。我一般会在Library path里加两条：D:\Components\Raize_6.1.1.12_Berlin\Source和D:\Components\Raize_6.1.1.12_Berlin\Packages\Win32。前者让编译器找到源码，后者让链接器找到.dcp和.bpl。如果是团队协作，可以把这些路径写进工程的.dproj文件里，或者用环境变量统一管理，避免每个人机器上的路径不一致。配置完可以新建一个空 VCL 工程，从组件面板拖一个RzButton到窗体上，按 F9 运行，如果能正常显示按钮，说明运行期和设计期都通了。
注意：安装设计期包之前，确认 IDE 里没有加载其他版本的 Raize 包。如果
Install Packages列表里已经有RaizeComponentsVcl_D但路径指向旧目录，先 Remove 再 Add 新路径，不要直接覆盖，否则会出现“包已加载但控件版本混用”的怪现象。
4. 避坑排查：安装 Raize 时最常翻车的五个现场
4.1 现象：编译运行期包时报F2613 Unit 'RzCommon' not found
原因：msbuild 没有找到 Raize 的 Source 目录，或者.dproj里的相对路径和你实际解压位置不匹配。修正版的包项目里可能写的是..\..\Source，如果你把Packages目录单独拷出来编译，相对路径就断了。解决：用前面提到的/p:IncludePath参数显式指定 Source 绝对路径，或者把整个修正版目录结构保持完整，不要只复制Packages子目录。我习惯在编译前先cd到Packages\Win32，确认上级目录里确实有Source文件夹，再用dir ..\..\Source\RzCommon.pas验证一下文件存在。
4.2 现象：设计期包加载时报Cannot load package 'RaizeComponentsVcl_D'，提示缺少RaizeComponentsVcl.bpl
原因：设计期包依赖运行期包，但 IDE 的包搜索路径里没有运行期包所在的目录，或者运行期包的平台版本不对（比如编译了 Win64 的运行期包，但设计期包是 Win32 的）。解决：先确认Packages\Win32目录下有RaizeComponentsVcl.bpl，然后检查 IDE 的Library path是否包含这个目录。如果路径正确但还是报错，用Dependency Walker这类工具打开设计期包，看它依赖的 BPL 名字和实际生成的文件名是否一致。修正版有时会改包名，比如把RaizeComponentsVcl.bpl改成RaizeComponentsVcl_6.bpl，这时候需要手动调整设计期包项目里的引用，或者把生成的文件名改回去。
4.3 现象：控件面板上 Raize 标签页出现了，但控件是灰色的，拖到窗体上没反应
原因：设计期包虽然加载了，但控件的注册信息没有正确写入 IDE 的组件注册表，常见于之前装过旧版 Raize 且没清理干净，或者 IDE 的Known Packages注册表项里有冲突。解决：关闭 IDE，打开注册表编辑器，定位到HKEY_CURRENT_USER\Software\Embarcadero\BDS\18.0\Known Packages，把里面所有包含Raize的字符串值删掉。然后删除HKEY_CURRENT_USER\Software\Embarcadero\BDS\18.0\Palette下的Raize子键（如果有的话）。重新打开 IDE，重新安装设计期包。如果还不行，在 IDE 里点Component→Install Packages，把 Raize 包 Remove 掉，然后手动打开RaizeComponentsVcl_D.dproj，点Install按钮（不是 Build），让 IDE 走一遍完整的注册流程。
4.4 现象：新建工程编译时提示Unit 'RzButton' not found，但设计期控件已经能拖放
原因：设计期包安装只影响 IDE 的组件面板，编译工程时编译器走的是Library path里的搜索路径。如果你的工程没有把 Raize 的 Source 目录和包输出目录加进去，编译器就找不到单元。解决：打开Project→Options→Delphi Compiler→Search path，把D:\Components\Raize_6.1.1.12_Berlin\Source和D:\Components\Raize_6.1.1.12_Berlin\Packages\Win32加进去。注意这个设置是每个工程独立的，如果团队里其他人拉取代码后也报同样的错，最好把这些路径写进项目的.dproj里，或者用 IDE 的Environment Options统一配置，避免每个人手动加。
4.5 现象：修正版装完后，原来工程里的一些 Raize 控件属性变成默认值，或者运行时行为异常
原因：修正版可能修改了某些控件的默认属性或事件签名，以适配 Berlin 的 VCL 变化。如果你的工程是从旧版 IDE 迁移过来的，窗体文件里保存的属性值和修正版控件类的默认值不一致，IDE 重新加载窗体时可能会重置部分属性。解决：安装修正版之前，先备份整个工程目录。装完后打开工程，逐个检查窗体上的 Raize 控件，重点看RzGrid的列定义、RzEdit的输入掩码、RzButton的图片列表等属性。如果发现属性丢失，从备份里对比.dfm文件，手动恢复。更稳妥的做法是先用修正版编译一个测试工程，确认控件行为正常后再迁移正式项目。
5. 验证安装：新建工程拖控件与运行时自检
5.1 设计期验证：控件面板与 About 对话框
安装完设计期包后，不要直接打开正式工程，先新建一个干净的 VCL Forms Application 做验证。在 IDE 里点File→New→VCL Forms Application - Delphi，然后在组件面板的Raize标签页里找几个代表性控件拖到窗体上：RzButton、RzEdit、RzGrid、RzPageControl。拖放时注意观察 IDE 的消息窗口，如果出现Access violation或者Class not registered，说明设计期包注册有问题，回到第 4 章排查。拖放完成后，右键任意一个 Raize 控件，看右键菜单里有没有About Raize Components这一项。点开它，弹出的窗口里会显示版本号6.1.1.12和构建信息。如果版本号正确，说明设计期包加载的是修正版，而不是系统里残留的旧版。
设计期验证还有一个细节：检查控件面板上的图标是否正常显示。有些修正版因为资源文件路径问题，图标会变成默认的空白方块，虽然不影响功能，但说明包里的资源编译不完整。这时候可以重新编译设计期包，或者检查Source目录下的.res文件是否被正确引用。我一般会在验证阶段拖一个RzGrid，双击它打开列编辑器，随便加两列，看编辑器能不能正常响应。如果列编辑器打不开或者报错，说明设计期的属性编辑器注册有问题，后续开发会很难受，必须在这个阶段解决。
5.2 运行期验证：一个最小示例
设计期没问题后，写一个最小运行时代码，验证控件的核心功能。以下代码放在窗体单元的FormCreate事件里，用RzButton弹出一个消息框，并用RzEdit做简单的输入校验。代码中的控件名按你实际拖放的命名调整：
procedure TForm1.FormCreate(Sender: TObject); begin // 初始化 RzEdit，设置输入掩码为电话号码格式 RzEdit1.Text := ''; RzEdit1.MaxLength := 11; RzEdit1.EditMask := '(999) 000-0000;1;_'; RzEdit1.Text := '13800138000'; // 初始化 RzButton，绑定点击事件 RzButton1.Caption := '校验号码'; RzButton1.OnClick := RzButton1Click; end; procedure TForm1.RzButton1Click(Sender: TObject); begin // 检查 RzEdit 的文本是否为空 if Trim(RzEdit1.Text) = '' then begin ShowMessage('号码不能为空'); Exit; end; // 利用 RzEdit 的 EditMask 验证输入格式 if not RzEdit1.ValidateEdit then begin ShowMessage('号码格式不正确，请按 (999) 000-0000 输入'); Exit; end; ShowMessage('输入通过：' + RzEdit1.Text); end;这段代码里，EditMask属性是 Raize 的RzEdit特有的输入掩码设置，(999) 000-0000;1;_表示区号三位数字、空格、七位数字，;1表示掩码字符是否保存到 Text 里，;_表示空白占位符。ValidateEdit方法会按照掩码规则检查当前文本，返回布尔值。运行后，如果输入不完整或者格式不对，点按钮会弹出提示；格式正确则显示通过信息。这个示例同时验证了控件的绘制、事件绑定和输入校验三个核心环节。如果你拖的是RzButton，运行时按钮的样式应该比标准TButton更扁平或者带渐变，具体取决于修正版里默认的Style设置。如果按钮显示成普通 Windows 按钮，说明 Raize 的控件注册没有完全生效，可能只加载了部分包。
运行时还可以检查RzGrid的数据绑定。从组件面板拖一个RzGrid和一个DataSource，在代码里动态创建一个ClientDataSet并绑定，看网格能否正常显示列和数据。如果网格显示空白但列头正常，通常是ClientDataSet没有打开或者字段定义没匹配。这类问题属于使用层面的配置，不是安装问题，但能帮你确认 Raize 控件在运行时确实在工作，而不是只有一个空壳。
6. 修正版进阶：批量部署与多平台编译的一个小技巧
团队里如果有多个开发者需要装这套环境，挨个手动点 IDE 安装太费时间，而且容易因为路径差异导致有人成功有人失败。我一般会写一个批处理脚本，把编译、拷贝和注册表配置串起来，新机器上执行一次就能把运行期包和设计期包都准备好。下面这个脚本的思路是：先调用rsvars.bat初始化环境，然后编译 Win32 运行期包和设计期包，最后把包路径写入当前用户的Known Packages注册表项。注意注册表操作需要管理员权限，而且写入前要先备份原有键值。
@echo off setlocal rem 设置修正版解压根目录，按实际路径修改 set RAIZE_ROOT=D:\Components\Raize_6.1.1.12_Berlin set BDS_VERSION=18.0 rem 初始化 Delphi 编译环境 call "C:\Program Files (x86)\Embarcadero\Studio\%BDS_VERSION%\bin\rsvars.bat" rem 编译 Win32 运行期包 cd /d "%RAIZE_ROOT%\Packages\Win32" msbuild RaizeComponentsVcl.dproj /p:Config=Release /p:Platform=Win32 /t:Build /v:minimal if errorlevel 1 ( echo 运行期包编译失败，检查 Source 路径 exit /b 1 ) rem 编译 Win32 设计期包 msbuild RaizeComponentsVcl_D.dproj /p:Config=Release /p:Platform=Win32 /t:Build /v:minimal if errorlevel 1 ( echo 设计期包编译失败 exit /b 1 ) rem 将包路径写入当前用户的 Known Packages 注册表 reg add "HKCU\Software\Embarcadero\BDS\%BDS_VERSION%\Known Packages" ^ /v "%RAIZE_ROOT%\Packages\Win32\RaizeComponentsVcl_D.bpl" /t REG_SZ /d "Raize Components 6.1.1.12 Design Package" /f echo 编译完成，注册表已更新。请手动打开 IDE 的 Install Packages 确认加载。 endlocal脚本里reg add那一行把设计期包的完整路径写进Known Packages，键名就是 BPL 文件的绝对路径，键值可以填一段描述。这样下次打开 IDE 时，Berlin 会自动尝试加载这个包。但注意，自动加载的前提是运行期包的路径已经在Library path里，否则 IDE 加载设计期包时还是会报找不到依赖。所以脚本执行完后，还需要在 IDE 里手动检查一次Library path，把%RAIZE_ROOT%\Source和%RAIZE_ROOT%\Packages\Win32加进去。这一步没法完全脚本化，因为 Berlin 的库路径存在注册表的Library Path键里，格式比较复杂，手动配置更稳妥。
多平台编译方面，如果项目需要 Win64 版本，不能只编译 Win32 包。你需要把Packages\Win64目录下的运行期包项目用msbuild编译一遍，平台参数改成Win64，然后把生成的.bpl和.dcp路径加到 Win64 的Library path里。设计期包一般只需要 Win32，因为 IDE 本身是 32 位的，但运行期包必须两个平台都编译。我踩过的坑是：只编译了 Win32 运行期包，结果 Win64 工程编译时提示Unit 'RzCommon' not found，因为 Win64 的库路径里没有对应的.dcp。后来养成习惯，装完 Raize 后立刻用msbuild把 Win64 运行期包也编译出来，放在Packages\Win64下，再统一加路径。这样不管团队里谁切到 Win64 平台，都不会因为缺包卡住。
从那以后我每次装 Delphi 第三方控件包，都强制走一遍“先编运行期、再编设计期、最后手动验证拖控件”的流程，不再相信安装脚本里的一键完成。希望帮到你。
本文还有配套的精品资源，点击获取
