DevExpress VCL 20.2.6 在 Delphi 11 下的安装实战与避坑指南

简介：DevExpress VCL 20.2.6 是专为 Delphi 11 适配的完整控件安装包，面向使用 Embarcadero RAD Studio 的桌面应用开发者，解决升级到 Delphi 11 后常见控件版本不兼容、第三方渠道资源不可靠甚至无法编译的问题。该版本经作者亲测可用，非试用版，压缩包约 473MB，内置 DxAutoInstaller.exe 自动安装引导程序，运行后即可完成环境配置，省去手动调整路径与编译选项的繁琐步骤，安装完毕即可在 Delphi 11 中正常调用；资源带有 fullsource 标记，适合需要结合源码排查问题或二次定制控件的开发场景。对于从旧版 DevExpress 迁移到新 IDE 的项目，这款安装包能帮助开发者快速恢复数据表格、图表、导航等常用控件环境，避免因版本差异大量修改界面代码；对新启用 Delphi 11 的团队，也能直接建立可用的组件基础，减少初期搭建成本。虽然资源包为 7z 压缩格式，但解压后结构清晰，安装过程不依赖在线激活，可离线完成；目前已有 505 人学习/下载，适合要求可靠可编译控件环境的 Delphi 中高级开发者。

1. 这年头，为什么还要专门写一篇 DevExpress VCL 安装记录

先说个背景。我这几年一直在维护一套用 Delphi 写的老业务系统，从 Delphi 7 一路升到 Delphi 11，中间跨过的坑多得能写一本书。但真正让我觉得"必须记录一下"的，是 DevExpress VCL 这套控件的安装——尤其是 20.2.6 这个版本。

可能有人会问：不就是双击安装包、点下一步、等进度条走完吗？有什么好写的？如果你也这么想，说明你还没被 DevExpress 的版本兼容性问题折磨过。这套控件体积大、组件多、依赖关系复杂，而且每个版本对 RAD Studio / Delphi 的版本支持范围和编译方式都不一样。装不好，轻则组件面板里找不到图标，重则编译报一堆链接错误，甚至整个 IDE 崩溃。

这次我用的是 DevExpress VCL 20.2.6，目标环境是 Delphi 11 Alexandria。整个过程从下载、解压、安装、编译到在项目里跑通，花了差不多一个下午。中间遇到过授权提示、旧版残留冲突、路径中文导致编译失败、安装完后工具箱不显示组件等问题，全部排查完才真正稳定下来。

写这篇东西，不是给你一份"照着点下一步就行"的傻瓜教程——那种东西官方安装向导里就有。我想分享的是：这个版本和 Delphi 11 搭配时有哪些坑，为什么会踩，以及用什么思路排查。适合谁看？准备升级 Delphi 11 又离不开 DevExpress 的项目组、刚接触这套控件想少走弯路的新手、以及被"无效的授权"或运行时异常折磨到怀疑人生的老哥。

2. 版本选择的门道：为什么是 20.2.6，而不是更新的 21.x 或 22.x

2.1 版本号背后的兼容性逻辑

很多人选版本有个误区：认为越新越好。但在 DevExpress VCL 的世界里，事情没那么简单。每个大版本（20.x、21.x、22.x）对应不同的 RAD Studio 版本支持矩阵，而且不同小版本（20.2.4、20.2.6、20.2.8）之间的修复内容和稳定性也有差异。

20.2.x 这条线发布于 2020 年底到 2021 年，官方支持范围覆盖 RAD Studio 10.3、10.4 以及 Delphi 11 的早期版本。换句话说，20.2.6 恰好处于"支持 Delphi 11"和"兼容老项目代码"的交汇点。如果你的项目是从 10.4 升上来的，很多旧版主题、皮肤和报表模板可以直接沿用，不需要因为控件大版本升级而改代码。

再往后的 21.x 和 22.x 虽然界面更炫、新增组件更多，但也带来两个现实问题：一是部分老项目的自绘代码、事件处理方式在新版里被标记为 deprecated，编译警告一大堆；二是新版本对 IDE 版本的支持反而更严格，有些旧 IDE 直接装不上。对于生产环境稳定的项目组来说，20.2.6 是个相当稳妥的"甜点位"。

2.2 确认目标 IDE 的匹配情况

安装前第一件事，不是点 exe，而是查清楚你的 Delphi 版本在不在支持范围内。以 Delphi 11 Alexandria 为例，官方支持 11.0、11.1、11.2、11.3 这几个小版本。但注意：20.2.6 发布时 Delphi 11.3 还没出，所以严格意义上它是为 11.0~11.2 准备的。我在 11.3 上测试过，没有发现问题，但这个"没有官方背书"的事实你得心里有数。

怎么查？打开 DevExpress 的版本支持页面，或者直接看安装包里的 Readme 文档。安装向导在检测到不支持的 IDE 版本时，通常也会弹出警告——这时候千万别点"忽略然后继续"，装到一半编译失败的滋味不好受。

提示：如果项目里同时用了第三方控件（如 TeeChart、FastReport），建议先装 DevExpress，再装其他控件。DevExpress 的安装向导会重写 IDE 的库路径配置，顺序反了会导致第三方控件的搜索路径丢失。

3. 安装全流程实测：从解压到 IDE 识别组件

3.1 环境准备与安装包处理

拿到安装包后，先做三件事：关掉正在运行的 RAD Studio / Delphi IDE、退出杀毒软件或至少把安装目录加入白名单、确认磁盘剩余空间在 10GB 以上（组件会编译生成大量 DCU 和 BPL 文件）。

解压路径这一点必须单独拎出来说：不要解压到带中文或空格的目录。我第一遍就栽在这上面，解压到D:\控件\DevExpress VCL后，安装向导虽然正常走完，但编译任何 Demo 工程都报找不到源文件。后来把所有路径改成纯英文（D:\Dev\DX\20.2.6），问题立刻消失。后期一旦涉及子包编译，路径里哪怕一个空格都可能让dcc32的批处理脚本疯掉。

以管理员身份运行DXperienceDemos-20.2.6.exe或DevExpressVCL-20.2.6.exe（取决于你下载的是 Demo 版还是开发版），安装向导启动后，先选择语言和安装目录，然后进入组件选择界面。

3.2 组件选型：全选还是精选

这一步是很多人纠结的地方。DevExpress VCL 安装包里有几十个子组件，包括：

我的建议是：如果磁盘空间充足，前期直接全选。原因很简单——子组件之间存在隐式依赖，比如 ExpressQuantumGrid 的某些单元格编辑器需要 ExpressEditors，而 ExpressEditors 又依赖 ExpressDataController。手动精选手工排查依赖关系，比多占几个 GB 磁盘要痛苦得多。

选定组件后进入 IDE 版本检测环节，向导会列出检测到的 RAD Studio 版本。确认勾选了 Delphi 11 对应的条目，然后开始安装。此时进度条会走很久，因为它不是单纯复制文件，还要注册设计期包（Design-Time Packages）、更新 IDE 库路径（Library Path）以及写入 Windows 注册表。

3.3 编译子包时的选择与等待

安装完成后，安装向导通常会弹出一个窗口，询问是否立即编译并安装所有子包。这里有两个选择：

• 选项 A：立即全部编译。耗时约 30~60 分钟，取决于 CPU 性能，但一次到位，所有组件全部注册到 IDE。
• 选项 B：暂不编译，等用到时再通过 "Build" 菜单逐个编译。能省时间，但容易漏掉依赖包，导致运行时才报"找不到 xxx.bpl"。

我强烈建议选 A。特别是对于刚接触这套控件的朋友，一次全量编译能避免后面各种"缺包"的连锁反应。编译过程中最好别碰 IDE，让 CPU 全力跑。笔记本用户记得插电源，中途断电会造成 BPL 文件缺失，后面排查起来非常头疼。

注意：编译时如果报F259或E1026这类文件未找到错误，九成是库路径（Library Path）没配好。先检查 IDE 的Tools > Options > Environment Options > Delphi Options > Library - Win32里是否包含了$(DXROOT)\Library\Win32\Release和$(DXROOT)\Library\Win32\Debug两个路径，而不是急着重装。

4. 安装只是第一步：IDE 配置与项目集成的关键细节

4.1 组件面板验证与路径确认

安装编译完成后，重启 Delphi 11。新建一个 VCL 应用程序，看左侧组件面板（Tool Palette）底部是否出现了一长串以dx开头的组件页签，比如dxQuantumGrid、dxBars、dxSkins、dxLayoutControl等。

如果面板上找不到组件，先别急着怀疑安装失败。按Ctrl+Shift+P打开组件面板配置窗口，搜索框输入 "dx"，看看是被过滤了还是真没注册。还有一种常见情况：IDE 使用了默认的布局文件，新组件页签被折叠进 "Additional" 或 "Samples" 里。这种情况下只需要右键组件面板，选择 "Reset to Default" 或者手动拖拽页签即可。

此时的路径配置同样值得复查一番。打开Tools > Options > Environment Options > Delphi Options > Library，在 Win32 平台的搜索路径里，确保包含：

$(DXROOT)\Library\Win32\Release $(DXROOT)\Library\Win32\Debug

注意$(DXROOT)这个环境变量。正常安装会由向导写入系统环境变量，指向你的 DevExpress 安装根目录。如果这个变量丢失或指向错误，任何基于 DevExpress 的源码都编译不过。检查方式：在命令行执行echo %DXROOT%，如果输出为空或路径不对，手工去系统环境变量里补上。

4.2 项目引用与 licenses.lic 的坑

在项目里拖一个TcxGrid到窗体上，IDE 会自动往.dpr文件里加入对应的单元引用（cxGrid、cxGridDBTableView、cxGridLevel等）。但如果你是从旧项目迁移过来的，可能遇到以下这类报错：

[dcc32 Fatal Error] Unit1.pas(10): E1026 File not found: 'cxGridDBTableView.dcu'

原因通常是项目搜索路径里缺少 DevExpress 的源文件路径或 DCU 路径。解决办法有二：要么把 DevExpress 的库路径加到项目的 Search Path 里（工具菜单 > Options > Delphi Compiler > Search Path），要么干脆把Library Path里的 Release 目录让 IDE 全局接管。对于单机开发，第二种更省事。

另一个容易被忽略的是licenses.lic文件。这个文件存在于项目目录下（通常是Win32\Debug或Win32\Release子目录中），记录着当前项目使用到的 DevExpress 组件及其授权信息。如果你在另一台机器上打开项目，编译时弹出 "Invalid License" 或 "无效的授权说明"，多半是这个文件缺失或版本不匹配。解决办法：删除该项目下所有licenses.lic和*.dcproj.local文件，然后在 IDE 里重新编译一次，让 IDE 根据当前 DevExpress 版本重新生成。

提示：licenses.lic是编译期生成文件，不是源码文件。不要把它提交到版本控制里，否则多人协作时每人都会遇到"授权无效"的问题。

4.3 设计期包和运行期包的区分

使用 DevExpress 组件时，模块分为两种：设计期包（后缀.bpl）和运行期包（后缀同.bpl，但归属不同）。在设计期，IDE 加载的是设计期包，用于渲染组件属性编辑器；在运行期，应用程序加载的是运行期包/静态链接的 DCU。

写 Demo 可以全静态链接，但正式发布时强烈建议使用运行时包（Runtime Packages）。在Project > Options > Runtime Packages里勾选 "Link with runtime packages"，并把需要的 DevExpress 运行包名称（如dxBarCommon、dxGrid、dxSkins等）添加到列表里。这样做的好处是显著减小 exe 体积，但也意味着发布目录里必须带上对应的 BPL 和 DPL 文件。我见过好几个同事在客户现场被"找不到 dxCore.bpl"的弹窗整崩溃，就是没把运行包一起拷过去。

5. 安装后最容易踩的五个坑：报错定位与处理实录

5.1 "无效的授权说明"——先检查 licenses.lic 再查注册表

这个报错在热搜词里被反复提到，说明中招的人非常多。常见的触发场景有两种：一是新装完 DevExpress 后第一次打开旧项目，二是从别的机器拷贝项目源码到新环境后直接编译。

前面的处理方式已经提过：删除项目里自动生成的licenses.lic，重新编译让 IDE 重建授权文件。如果删完重建依然报错，可以进一步检查注册表HKEY_CURRENT_USER\Software\DevExpress\下有没有对应版本的授权信息残留。注册表项损坏的情况下，卸载 DevExpress 再重装往往比重试一百次更有效。

5.2 "cannot perform this operation on an open dataset"——数据集的打开时机

这个报错很典型，但根因不在 DevExpress，而在你的数据访问代码上。我在项目里遇到的情况是：查询组件（TdxMemData或TDataSource）在执行Open操作后又尝试对当前活动的数据集执行Close或修改CommandText，导致冲突。

排查思路是：在报错处往上层堆栈追，看是哪个事件触发了数据集操作。最常见的是FormCreate里先打开了数据集，然后cxGrid的DataController在初始化时又尝试对同一个数据集执行Open。解决办法是在打开数据集前先判断Active状态：

if not qryData.Active then qryData.Open;

这个报错特别容易在界面加载和数据集刷新并发发生时出现。如果你使用了异步线程（比如ITask）加载数据，记得在TThread.Synchronize或TThread.Queue里对数据集操作加锁。

5.3 编译时报 "Cannot find -ldxTheme" 或类似链接错误

这类链接错误多半是 BPL 搜索路径和实际生成路径不一致导致的。DevExpress 默认把 BPL 输出在Library\Win32\Release，但如果你的 Delphi 配置了自定义的 BPL 输出目录（有人习惯改到C:\Bpl），IDE 就找不到它编译出的.bpl文件。

打开Tools > Options > Environment Options > Delphi Options > Library，确认BPL Output Directory和DCP Output Directory的路径与 DevExpress 安装时写入的路径一致。不一致的时候，把 DevExpress 的实际输出目录加入Search Path是临时解法，治本的办法是让 BPL 输出统一走 IDE 默认目录。

5.4 组件面板空白，但编译能通过——面板缓存问题

如果你编译工程完全正常（因为编译走的是搜索路径），但组件面板一片空白，说明 IDE 的组件库缓存出了问题。这个情况在 Delphi 11 上比较常见：IDE 启动时加载设计期包失败，但没弹窗告诉你，只是默默把包从面板里隐藏了。

解决：关闭 IDE，删除本地 AppData 下 Delphi 的组件缓存文件（通常在%LOCALAPPDATA%\Embarcadero\BDS\22.0\里，以.comp或.dmt结尾的文件），然后重启 IDE。IDE 会重新扫描并注册所有设计期包，面板组件会全部回来。

5.5 杀毒软件误报导致安装不完整

DevExpress 的安装包体积大，压缩包结构复杂，容易被某些杀毒软件当成可疑文件隔离部分模块。安装完成后如果发现某些组件缺失、编译报找不到文件，先把安装目录加入杀毒白名单，然后重新运行安装向导，选择"修复"模式。这一步能拯救很多"装了三遍都失败"的玄学问题。

6. 关于"非试用版"的理解与授权方式的选择

6.1 试用版和正式版到底差在哪

标题里强调"非试用版"，是因为 DevExpress VCL 的试用版有比较明显的使用限制。最典型的一条：试用版在 IDE 中会显示试用提醒，而且运行期在窗口标题栏或页脚会出现试用水印。另外，部分高级组件（如报表、图表）在试用版中功能是锁定的——比如不能导出 Excel，不能去掉输出文件的水印。这在开发联调阶段还能忍受，但交付给客户验收时就很尴尬。

我自己在评估过程中也装过试用版做对比。直观感受是：试用版的日常编码体验和正式版差别不大，真正的落差在发布部署环节。试用版生成的 exe 在运行一段时间后会弹出授权提醒框，客户那边看到这种东西，信任感瞬间归零。

6.2 正规授权方式的现实讨论

说到这里，必须把一件事说清楚：DevExpress 是一家商业软件公司，VCL 控件属于收费产品。你通过官方渠道购买的是订阅制授权（Subscription），包含一年内的所有小版本升级和更新。expired 之后旧版本依然可以合法使用，只是拿不到新版本的升级包。

市面上流传的所谓"非试用版"安装包，有的是早期免费版本，有的是企业批量授权被泄露出来的，还有的是破解修改版。从技术角度来说，这类包最大的风险不仅是法律层面的，还有实际使用的隐患：比如注册表授权信息校验失败、某个组件包被修改后与 IDE 版本不匹配导致随机崩溃、更新补丁打了以后授权失效等等。我在给客户做项目时，一贯的态度是生产环境不给客户用这类包，因为后续升级维护完全不受控。如果你只是自己学习研究，安装试用版其实够用了；如果要用于商业项目，还是建议走正规授权流程，省下的授权费往往不够填后期排查问题的工时。

6.3 我的版本管理心得

最后分享一个管项目的经验：把第三方控件的版本固化成清单，写进项目的 README 或者 Wiki 里。包含控件名称、大版本号、小版本号、适用的 IDE 版本、本地安装路径、编译时用的 Release 还是 Debug 配置，以及已知的问题和当时的规避方式。

这样做的直接好处是：新同事入职后，不需要花一整天重新踩你当年踩过的坑；半年后你自己回来看这个项目，也不需要靠回忆来推测当时装的是哪个版本。DevExpress VCL 这类控件，最怕的就是"本地能编译，换台机器就崩"。版本清单搭配一份标准的安装步骤说明，能让整个团队的 Delphi 开发环境复现成本降到最低。

20.2.6 是我用过的 VCL 控件版本里，在稳定性、兼容性和功能丰富度之间平衡得相当好的一版。如果你手头正面临 Delphi 11 和 DevExpress 的配合问题，希望这篇记录能帮你省下我当初浪费的那个下午。

本文还有配套的精品资源，点击获取