同一项目混用Delphi 10.4与12.2的兼容性解决方案咨询

一、不同Delphi版本共存的最优方案 #

1. 分支隔离+严格合并校验 #

用Git创建版本专属分支：

• 核心分支（如main）仅兼容最低版本（Delphi 10.4），所有提交必须在10.4下编译通过。
• 单独创建delphi12分支用于12.2的特性开发，仅在该分支中使用高版本专属API或特性。
• 合并delphi12到main时，必须将高版本代码用条件编译包裹，确保核心分支的兼容性。

2. 条件编译强制隔离高版本特性 #

利用Delphi预定义的版本宏（VERxxx）包裹专属代码，旧版本编译时自动跳过：

// Delphi 10.4对应VER350，12.2对应VER360
{$IFDEF VER360}
// 仅12.2支持的代码，比如新增的样式API、组件属性
StyleManager.ApplyCustomStyle('NewStyle');
{$ELSE}
// 10.4兼容的替代实现（或空实现）
{$ENDIF}

对于窗体文件（.dfm），同样可以用条件编译隔离高版本属性：

object Button1: TButton
  {$IFDEF VER360}
  StyleLookup = 'ModernButton'
  {$ENDIF}
  Caption = 'Button'
end

3. 项目文件按版本分离 #

将.dproj文件拆分为版本专属文件，比如Project_104.dproj和Project_122.dproj，共享所有源码和窗体文件。不同版本的开发者各自使用对应项目文件，避免新版本项目中的配置（如样式、编译器选项）触发旧版本的兼容性错误。

4. 团队统一规范约束 #

• 禁止在核心分支中使用仅高版本支持的语法、组件或属性。
• 提交代码前必须在目标版本编译器中编译验证，避免引入隐藏的兼容性问题。

二、移除引发问题的高版本特性的工具/方法 #

1. 手动结合条件编译（最可靠） #

没有万能的一键移除工具，最稳妥的方式是手动定位高版本特性代码，用条件编译隔离。针对你遇到的ECustomStyleException错误，通常是.dfm或.dproj中加入了10.4不识别的样式属性：

• 用文本编辑器打开报错的.dfm文件，查找Style相关的属性（如StyleLookup、CustomStyle），删除或用{$IFDEF VER360}包裹。
• 检查.dproj文件中的新版本配置项，移除旧版本不支持的节点（如CustomStyles相关配置）。

2. 自定义脚本批量处理 #

可以编写简单的Pascal控制台程序，扫描源码和窗体文件：

• 匹配并移除{$IFDEF VER360}到{$ENDIF}之间的代码块（适用于需要临时降级的场景）。
• 查找特定的高版本属性关键字（如StyleLookup）并删除对应的行。

3. 静态代码分析辅助定位 #

用Delphi自带的Code Insight或第三方静态分析工具扫描代码，定位仅高版本支持的API或属性，再手动处理。

内容的提问来源于stack exchange，提问作者Franz