简介：这是面向 Delphi 开发者的 XLSReadWriteII 6.02.01 第三方 Excel 读写组件包，适用于需要在 Object Pascal 项目中直接创建、读取和修改工作簿的中高级开发者，可解决 Delphi 应用与 .xlsx 等表格格式之间的数据互通问题。压缩包共 505 个文件，约 5.63MB，以 pas 单元源码、dfm 窗体、dpr 示例工程为主体，辅以 html 帮助文档、obj/dcr 组件资源及 dproj、cfg 工程配置，源码与示例并存，便于查看实现细节并在 IDE 中逐步调试。内容包含图表、数据透视表、自动筛选、发票、文件监控等示例工程配置，可对照学习表格写入、单元格格式化与导入导出的实际用法。该组件声明支持 D7 至 D12.2，覆盖版本跨度较大，老项目迁移与新版本升级均能参考。目前已有 587 人浏览学习，适合希望减少自研 Excel 模块成本、快速为业务系统补充报表功能的开发者取用。
1. 先别急着解压：D7 到 D12.2 的 XLSReadWriteII 6.02.01 安装前要看的版本账
某开发者在迁移一个 Delphi 12 控件项目时，机器上同时装着 D7、D10.4 和 D12.2，旧工程引用早期 XLSReadWriteII，新包换成 XLSReadWriteII 6.02.01（29 Nov 2024）。
IDE 能打开，组件面板却没有页签，编译时又报 unit not found。这个场景太常见：包写着支持 D7 到 D12.2，不等于一个设计期包能无脑覆盖所有 IDE；装不好，轻则面板空白，重则设计期包和运行期包互相打架。
下面按我实际装这套环境的顺序走，适合正在做旧项目迁移、xls 导入导出和报表落地的读者。
2. 环境准备：D7 到 D12.2 的目录、位数和包类型先对齐
装 Delphi 控件最容易翻车的地方，不是点 Install 那一下，而是前面的版本账没算清。XLSReadWriteII 6.02.01 覆盖 D7 到 D12.2，跨度很大，D7 的包工程、D12.2 的包工程、32 位设计期包、64 位运行期包，这几件事混在一起，后面就会出现“面板有组件但编译不过”或者“开发机正常客户机起不来”的问题。我一般先把 IDE 版本、目标平台、包后缀三样写在纸上，再动手解压。
2.1 先确认 IDE 版本、目标平台和包后缀
D7 时代常见的是.dpk包工程，较新的 IDE 更多见.dproj或包组工程；设计期包给 IDE 加载，运行期包给应用编译或分发用，这两个不是同一个东西。D7 只有 Win32 目标，D12.2 会同时有 Win32 和 Win64 目标，设计期包通常只装在 32 位 IDE 环境里，运行期包则要按目标平台分别编译。先把当前机器上的 IDE 找出来，不要靠开始菜单名字猜。
# D7 常见 delphi32.exe，较新 IDE 常见 bds.exe；找不到就把安装目录临时加进 PATH $names = 'bds.exe','delphi32.exe' foreach ($n in $names) { Get-Command $n -ErrorAction SilentlyContinue | ForEach-Object { $item = Get-Item $_.Source [PSCustomObject]@{ Name = $n Exe = $item.FullName Version = $item.VersionInfo.FileVersion } } }这段命令只做一件事：确认命令行能调用到哪个 IDE 可执行文件，并打印版本号。Source是完整路径，FileVersion用来区分 D7、D10.x、D12.2 这类代际。D7 的 IDE 程序名和较新版本不同，所以两个名字都要查。查不到不代表没装，可能只是没进 PATH，这时去快捷方式属性里看目标路径更直接。
| IDE 代际 | 包工程常见后缀 | 设计期包加载位数 | 运行期包目标 |
|---|---|---|---|
| D7 | .dpk | 32 位 | Win32 |
| D10.x 到 D12.2 | .dproj或.dpk | 32 位 | Win32 / Win64 |
这张表的作用是防止把 Win64 运行期包当设计期包安装。设计期包加载不进 IDE，组件面板就不会出现；运行期包没编对，应用换平台就会报单元版本不一致。先把这条线划清，后面少很多玄学问题。
2.2 7z 解压后的目录别随手放：建议统一到版本化目录
我不建议把控件解压到项目目录里，也不建议放在带空格、带中文、带同步盘的路径下。项目一清理bin、dcu，很容易把组件目录一起带走；同步盘在 IDE 编译时锁文件，也会制造一些很难复现的报错。常见做法是统一放到D:\Dev\Components\XLSReadWriteII\6.02.01这种版本化目录，换版本时只改父级路径，旧版本还能留着回滚。
# 文件名按你实际拿到的压缩包改；x 表示保留目录结构，-o 指定输出目录，-y 覆盖不提问 $pkg = 'D:\Downloads\XLSReadWriteII_6.02.01_for_D7-D12.2.7z' $root = 'D:\Dev\Components\XLSReadWriteII\6.02.01' New-Item -ItemType Directory -Force -Path $root | Out-Null 7z x $pkg "-o$root" -y # 先看一级目录，确认解压出来的是包工程、源码、库目录，还是一个外层壳目录 Get-ChildItem $root -Directory | Select-Object Name, FullName7z x和7z e的区别要留意：x保留目录结构，e会把文件平铺到一层，后面找.dpk、.dproj和库路径时很容易乱。-o后面不要加空格，"-o$root"这种写法在 PowerShell 里更稳。解压后如果发现多了一层同名目录，就把$root再往下指一级，不要让 Library Path 指到壳目录。
提示：组件目录和项目目录分开，后面装坏了可以直接换回旧版本目录，不用在 IDE 里一层层删路径。
2.3 管理员权限、杀毒软件和只读目录
设计期包安装时，IDE 会往自己的包输出目录写.bpl、.dcp一类文件；如果 IDE 装在受保护目录下，普通权限可能写不进去，表现就是 Build 成功、Install 没反应，或者重启 IDE 后包又没了。我一般会先把 IDE 以管理员身份运行一次，装完再改回普通启动，避免日常开发一直带高权限。
另一个常见干扰是杀毒软件。它不一定报毒，但可能在 IDE 写.bpl的瞬间锁文件，导致“找不到包”或者“包已加载但没有注册组件”。如果前面步骤都对，组件面板还是空白，可以临时把组件输出目录加入排除项，再重装一次设计期包。
# 在组件根目录做一次写入探测；失败就先查权限，不要继续往下装 $probe = Join-Path 'D:\Dev\Components\XLSReadWriteII\6.02.01' 'write_test.txt' try { 'ok' | Set-Content $probe -ErrorAction Stop Remove-Item $probe -Force '目录可写' } catch { '目录不可写，检查权限或换到用户目录' }这段探测不是必做，但在公司电脑、受限账户、受控目录上很省时间。目录不可写时，先换到D:\Dev这类用户可写位置，再重新解压。不要在这时候怀疑包本身，很多“装不上”其实是权限问题。
3. 安装设计期包：把 XLSReadWriteII 6.02.01 挂进组件面板
环境目录定好之后，才进入 IDE 安装。这里最容易犯的错是直接在资源管理器里双击.dpk，系统拿什么程序关联就用什么程序打开，最后装到另一个 IDE 里去了。正确做法是先打开目标 IDE，再从 IDE 里打开包工程；D7 和 D12.2 分别装，不要指望一次安装两边都认。
3.1 从 .dpk/.dproj 打开，不要直接双击乱装
先列出解压目录里的包工程候选，确认哪个是设计期包、哪个是运行期包。文件名里可能带 Design、Runtime、D7、D12 这类字样，也可能只有包名，具体以实际目录为准。不要只看文件名，打开包工程后看它注册的组件单元和依赖项更准。
# 不要在资源管理器里双击；先列出候选包工程，再回 IDE 里 File > Open Get-ChildItem 'D:\Dev\Components\XLSReadWriteII\6.02.01' -Recurse -Include *.dpk,*.dproj | Sort-Object FullName | Select-Object FullName, Length-Recurse是为了防止包工程藏在Packages或Source子目录里；-Include只挑包工程，不把示例程序混进来。看到多个.dpk时，先用 D7 打开 D7 对应的包，再用 D12.2 打开较新 IDE 对应的包。D7 打开高版本.dproj通常没有意义，反过来 D12.2 打开很老的.dpk也可能要转换，转换前先备份整个组件目录。
3.2 编译、安装与组件面板检查
在 IDE 里打开包工程后，先 Build，不要一上来就 Install。Build 阶段会把单元路径、依赖包、目标平台的问题暴露出来；Build 不过就点 Install，只会得到一个“安装成功但组件不显示”的假象。Build 通过后再点包编辑器里的 Install，然后到Component > Install Packages里确认设计期包已经勾选。
推荐顺序如下：
- IDE 里
File > Open打开对应的.dpk或.dproj。 Project > Build先编译，观察 Output 里有没有 Unit not found、缺少依赖包、目标平台不匹配。- Build 通过后，在包编辑器里点
Install。 - 打开
Component > Install Packages，确认设计期包处于勾选状态。 - 新建一个空白 VCL 工程，看组件面板是否出现 XLSReadWriteII 页签。
如果 Install 之后面板还是没有，先不要重复点击。关掉 IDE 再开一次，看包是否还在；如果包列表里有但没勾选，勾上再重启；如果包列表里根本没有，说明 Install 没有写进当前 IDE 的配置，回到 3.1 确认是不是开错了 IDE。
# 包输出路径通常围绕这两个宏转，具体以 IDE 的 Package 编辑器 Output 为准 $(BDSCOMMONDIR)\Bpl $(BDSCOMMONDIR)\Dcp # 设计期包和运行期包要分清： # 设计期包用于 IDE 加载和组件注册，运行期包用于应用编译或随 exe 分发这里不需要手动去改.bpl文件名。IDE 的包编辑器会按包工程设置输出，手动改名反而容易让包依赖对不上。你要关注的是 Output 里有没有报错、包是否注册到当前 IDE、组件页签是否出现这三件事。
3.3 32 位与 64 位包别混装
D12.2 下最容易混的是位数。设计期包给 IDE 加载，通常按 32 位处理；运行期包要按应用的 Target Platform 分别编译，Win32 应用用 Win32 运行期包，Win64 应用用 Win64 运行期包。把 Win64 包当设计期包 Install，常见结果是 IDE 提示加载失败；把 Win32 运行期包塞给 Win64 应用，常见结果是编译能过、运行时报包加载错误。
# 我的检查顺序： # 1. Project Manager 里当前 Target Platform 是 Win32 还是 Win64 # 2. 包工程的目标平台是否与当前 Target Platform 一致 # 3. 设计期包只装 IDE 能加载的那一套，运行期包按应用目标平台编D7 只有 Win32，反而简单；D12.2 要同时照顾 Win32 和 Win64。我的习惯是先在 Win32 下把设计期包和最小工程跑通，再切 Win64 编译运行期代码。不要在 Win32 还没通的时候就去折腾 Win64，两个平台一起报错，排查成本会翻倍。
4. 配置搜索路径与运行时：让 XLSReadWriteII 在 D7-D12.2 里都能找到单元
包装上了，只说明 IDE 能加载设计期包，不代表编译器能找到单元。Delphi 的 Library Path 和 Browsing Path 经常被混为一谈：Library Path 给编译器找.pas、.dcu，Browsing Path 主要给代码浏览和跳转用。只加 Browsing Path，代码里能看到单元，编译照样报 Unit not found。
4.1 Library Path 和 Browsing Path 怎么写
我一般先在用户环境变量里留一个组件根目录，Library Path 用宏引用。这样以后从 6.02.01 换到新版本，只改变量值，不用在每个 IDE 里逐条改路径。D7 在Tools > Environment Options > Library，较新 IDE 在Tools > Options > Language > Delphi > Library，菜单名字略有差异，位置都在 Library 相关页。
# 用户变量不需要管理员权限；重开 IDE 后生效 [Environment]::SetEnvironmentVariable( 'XLSRW', 'D:\Dev\Components\XLSReadWriteII\6.02.01', 'User' )设置完环境变量后，Library Path 里可以写$(XLSRW)\Source
本文还有配套的精品资源，点击获取
