AI 迁移 Delphi 代码时容易漏掉的六处语义差异
作者用 Delphi 13 实测六类迁移陷阱,涉及中点舍入、同名函数解析、字符串下标和数组复制等行为。移植到 C#、Java 或 C++ 后,即使代码能编译,也可能出现计算结果变化或意外共享数组。
AI 深度解读
AI 把 Delphi 代码迁到 C#、Java 或 C++,编译通过后,最难发现的往往是那些只在特定输入下出现的行为差异。比如 Round(2.5) 在 Delphi 里可以得到 2,照着函数名换成 Java 的 Math.round(2.5),结果就变成了 3。
作者用 Delphi 13 实测了六类容易被迁移工具改错的行为,涉及舍入、函数解析、字符串索引、赋值、对象生命周期和浮点精度。对程序员最有用的是,这六类差异都能变成具体的迁移验收用例。
同名函数要先查定义,再比结果
Delphi 的 System.Round 采用银行家舍入。数值正好落在两个整数中间时,取偶数,所以 Round(2.5) = 2,Round(3.5) = 4。C# 的 Math.Round 默认也采用这个规则,但 Java 的 Math.round(2.5) 和 C++ 的 std::round(2.5) 都返回 3。只拿 3.5 验收,三种语言都可能给你预期的 4,差异就漏过去了。
还得确认调用的是哪个 Round。作者实测,当 uses 列表的最后一个单元声明了自己的 Round,未限定名称的 Round(2.5) 会调用那个单元的函数。只把调用处交给 AI,它连对照哪个实现都可能选错。
下标和赋值看着对,访问和修改却可能错
原文测到的 Delphi 字符串行为是 S[1] 取首字符。迁到从 0 开始计数的环境时,循环起点、结束条件和 Copy 的起始位置都要一起核对。只改循环头,循环可能跑得通,截出来的字符串却会偏一位。原文没交代影响索引行为的编译设置,迁移时应以源项目的实际构建结果为准。
B := A 则要先看 A 的类型。静态数组和记录按值复制,修改 B 的数组元素或直接字段不会改到 A 对应的位置。C# 和 Java 的数组赋值会共享同一个数组。Delphi 的动态数组 array of T 也会共享,直到通过 SetLength 或 Copy 分离。迁移时如果一律克隆数组,原来依赖共享修改的代码也会变。
对象何时销毁,结果要跟哪个平台比
作者测到,在采用引用计数的接口实现中,同一个对象可以同时被对象变量和接口变量持有。最后一个接口引用释放时,对象就会销毁,原来的对象变量仍可能留着一个悬空引用。迁到垃圾回收环境后,普通对象引用可能让对象继续存活。如果原程序依赖析构时释放资源,迁移时就得明确资源应在哪一步释放。
Extended 的对照基准也要选对。它在 Win32 上是 10 字节的 80 位 x87 类型,在 Win64 上则是 8 字节的 Double 别名。同一份 Delphi 源码在两个平台上就可能算出不同结果。要替换的是 32 位遗留版本,验收时就该拿那份 Win32 构建的输出做基准。
我的判断
作者把这些实测整理成了 Delphi Behavior Contracts,包含英俄双语的 74 章和 89 张指令卡,记录了 879 次构建观察,以及在 Win32 和 Win64 上共 650 次运行。它可作为 Claude Code 插件、通用 skill 或离线 MCP server 使用,MCP Registry 的条目标识是 io.github.DIIIUA/delphi-behavior-contracts。文档没定论的问题,作者会列明。
有实测支撑的是这些 Delphi 行为。至于给 AI 装上这份参考资料能减少多少迁移错误,原文没给对照数据,常见误判的说法也来自作者的经验。比起只让 AI 读文档,我更倾向于把旧程序跑出来的结果写成对照测试。参考资料帮你找到边界,测试帮你确认项目在实际类型、编译设置和目标平台下的行为。
能拿来做什么
- 让 AI 改舍入逻辑前,先给它
uses列表和Round的实际定义,再用2.5和3.5对照旧程序与新实现的返回值。 - 用 Node 写迁移验收脚本时,可以给字符串截取准备首字符和末字符用例,给数组赋值准备「改
B后读A」的用例,同时保留应共享和应独立的两种预期。 - 如果旧服务依赖析构释放资源,把释放发生的时点写进测试。如果前端要展示复算后的数值,先确认业务以哪份 Win32 或 Win64 构建的输出为准。