1. 为什么 Delphi 13 的安装值得单独写一篇Delphi 13 是 Embarcadero 推出的一个较新版本很多从 Delphi 7、Delphi 10.2、Delphi 11 一路走过来的老开发者第一次装 Delphi 13 的时候都会有点懵——不是装不上而是装完之后发现编译不过、组件找不到、中文乱码、补丁没打对。我自己前前后后在三台机器上装过 Delphi 13踩过的坑足够写一篇完整的记录。先说清楚这篇内容适合谁看如果你是从旧版本迁移过来的 Delphi 老手这篇能帮你避开版本切换时的典型问题如果你是刚接触 Delphi 的新人这篇也能让你第一次安装就少走弯路。关键词里的Delphi 13 安装方法、Delphi 12、补丁安装、中文版本这些我都会在下面逐一展开。需要提前说明的是Embarcadero 的安装器这几年变化很大从早期的独立 ISO 到现在的在线安装器Web Installer再到离线 ISO 包不同渠道拿到的安装包行为差异明显。很多人装失败不是因为操作错而是因为一开始就选错了安装包类型。这一点我会在第二节详细拆。另外Delphi 13 对系统环境的要求比 Delphi 10.x 更严格尤其是 Windows 版本、.NET 运行时、Visual C 运行库这几项缺一个就可能在编译阶段报奇怪的错误。这些依赖不是安装器一定会帮你装好的需要手动确认。2. 安装包类型的选择在线安装器还是离线 ISO2.1 两种安装包的适用场景对比Embarcadero 官方提供两种主要获取方式一种是Web Installer在线安装器体积小下载后边装边拉取组件另一种是ISO 离线包体积大通常几个 GB但一次下载完就能离线安装。对比项在线安装器离线 ISO初始下载体积几十 MB数 GB安装过程是否依赖网络是全程依赖否断网/弱网环境容易中断失败稳定组件可选性安装时勾选灵活需在安装时勾选同样灵活重复安装/多机部署每次都要重新下载可复用同一份 ISO适合人群网络稳定、只装一台多机部署、网络不稳我个人的建议很直接只要你不是网络特别稳定、且只装一次一律选离线 ISO。在线安装器最坑的地方在于它下载组件的过程中如果网络抖动会出现部分组件已装、部分没装的半成品状态而这种状态下的报错往往很隐蔽——比如 IDE 能打开但某个特定平台的编译器缺失直到你切换目标平台编译时才暴露。2.2 离线 ISO 的校验与挂载拿到 ISO 之后第一件事不是急着双击而是校验文件完整性。ISO 下载过程中损坏是常见问题尤其是通过浏览器下载大文件时。校验方法是用官方提供的哈希值通常在同一下载页面的 checksum 文件里对比本地文件的 SHA-256。校验通过后Windows 10/11 可以直接右键 ISO 选择装载系统会把它挂成一个虚拟光驱。这里有个细节不要解压 ISO 到硬盘再安装直接装载虚拟光驱安装更稳因为安装器内部有些路径引用是相对于光驱根目录的解压后路径变化可能导致某些组件定位失败。提示如果你的系统是 Windows 7 或 Windows 8.1Delphi 13 官方已经不支持强行安装会遇到 .NET 版本和运行库的连锁问题不建议折腾。2.3 安装前的系统环境自查清单在真正点安装之前我习惯先做一遍环境自查这几项确认下来能省掉后面 80% 的报错Windows 版本建议 Windows 10 21H2 及以上或 Windows 1164 位。磁盘空间完整安装含多平台编译器建议预留 30 GB 以上只装 Windows 平台也要 15 GB 左右。.NET 运行时安装器本身和部分工具依赖 .NET缺了会在启动阶段就报错。Visual C 运行库多个版本的 VC Redistributable 都要装尤其是 2015-2022 合集。杀毒软件安装前临时关闭实时防护或者把安装目录加入白名单。这一点后面会专门讲。3. 安装过程中的关键勾选项与常见中断3.1 组件勾选装多了浪费装少了返工Delphi 13 的安装器会让你勾选目标平台和附加组件。这里最容易犯的错是全选结果装了两个小时磁盘占了几十 GB实际用到的没几个。我的建议是按实际需求勾Windows 平台必选这是主力。Android / iOS 平台只有做移动端才勾且需要额外配置 SDK第一次装建议先不勾。macOS / Linux 平台跨平台编译才需要普通桌面开发可以不勾。附加组件像 InterBase、部分第三方组件包用不到就别勾它们会拖慢安装并增加出错概率。勾选逻辑的核心是每多勾一个平台就多一套编译器和运行库的依赖链任何一环出问题都会让整个安装过程卡住或失败。先装最小可用集跑通之后再通过安装器补装是更稳的策略。3.2 安装中断的典型表现与处理安装过程中最常见的中断有三种第一种是卡在某个组件下载/解压阶段不动。如果用的是在线安装器多半是网络问题如果是离线 ISO可能是光驱读取或临时目录权限问题。处理办法是清理临时目录通常在%TEMP%下后重试。第二种是报安装发生错误可以通过以下方法排查包故障。这个提示在热词里也出现过它本质上是安装器在告诉你某个包package注册失败。排查思路是先看日志文件安装器一般会在临时目录或安装目录下生成 log找到具体是哪个包失败再针对性处理。很多时候是杀毒软件拦截了包的注册动作。第三种是安装到一半蓝屏或重启。这种情况通常是驱动或运行库冲突重启后重新运行安装器它一般能识别已安装部分并续装。注意安装过程中如果被杀毒软件拦截不要简单地允许一次而是要把整个安装目录和临时目录都加入白名单否则后续编译时还会被拦。3.3 安装路径的选择讲究默认安装路径通常在C:\Program Files (x86)\Embarcadero\...。这个默认路径本身没问题但有两个坑一是路径里不要有中文和空格以外的特殊字符。虽然现代安装器对中文路径的支持好了很多但某些第三方组件、命令行工具仍然对非 ASCII 路径处理不佳编译时可能报找不到文件的错误。二是如果 C 盘空间紧张可以改到其他盘但要注意改路径后某些硬编码路径的工具尤其是老版本的辅助工具可能失效。我的做法是 C 盘留足空间用默认路径省心。4. 装完之后的补丁、注册与首次启动配置4.1 补丁安装的顺序与注意事项热词里有一条补丁安装好了后续补丁打开方法和注意事项这其实点到了 Delphi 使用中的一个真实痛点Delphi 的补丁不是装完就完事后续还有打开和应用的步骤。Delphi 13 发布后通常会有若干更新补丁Update这些补丁的安装有顺序要求——必须先装基础版本再按版本号从小到大依次装补丁跳着装或者倒着装都可能失败。装补丁前建议先关闭 IDE 和所有相关进程否则补丁程序会提示文件被占用。补丁装完后有些补丁需要手动运行一个配置工具或在 IDE 里触发一次更新检查才能生效。这一步很多人会漏掉导致以为补丁装了但实际没起作用。判断补丁是否真正生效的方法是在 IDE 的关于对话框里看版本号确认它已经变成补丁对应的版本。4.2 首次启动的配置项第一次启动 Delphi 13会有一个初始配置向导问你默认的界面风格、是否导入旧版本设置等。这里有两个建议不要盲目导入旧版本设置。从 Delphi 10.x 或 11 导入的设置里可能包含旧版本特有的路径、组件注册信息导入后反而导致新版本找不到组件。建议先全新配置需要什么再手动加。界面风格按习惯选这个不影响功能但影响你后续的开发心情选一个自己看着舒服的即可。首次启动后建议立刻做一件事编译并运行一个最简单的空 VCL 程序。这一步能验证编译器、链接器、运行库是否都正常。如果这个都跑不起来说明安装有问题早发现早处理。4.3 中文环境下的编码设置热词里有Delphi 中文版本这里要澄清一个概念Delphi 本身没有单独的中文版本它是通过语言包和编码设置来支持中文的。Delphi 13 默认使用 Unicode 字符串这对中文支持是好事但如果你从旧项目迁移旧代码里可能有大量基于 ANSI 的字符串处理迁移时会遇到乱码。处理办法是在项目选项里确认字符集设置并在源码文件保存时统一用 UTF-8带 BOM 或不带 BOM 要一致。我踩过的坑是同一个项目里有的文件是 UTF-8 无 BOM有的是 GBK编译时中文注释和字符串就会乱。统一编码是迁移旧项目前的必做功课。5. 安装后高频报错的排查链路5.1 找不到某某包或包注册失败这是安装后最常见的一类问题。完整排查链路是这样的第一步确认报错的具体包名。IDE 的报错信息通常会给出包名或路径。第二步去安装目录下找这个包对应的.bpl文件是否存在。如果不存在说明安装时这个组件没装上需要重新运行安装器补装。第三步如果文件存在但注册失败多半是依赖的运行库缺失或权限问题。以管理员身份运行一次 IDE看是否能注册成功。第四步如果还是不行检查系统 PATH 环境变量里是否包含了 Delphi 的 bin 目录。有些包在注册时需要调用同目录下的其他 DLLPATH 不对就找不到。5.2 编译时报找不到单元或库路径错误这类问题的根源通常是库搜索路径Library Path配置不对。Delphi 13 的库路径分全局和项目两级全局路径在 IDE 选项里配项目路径在项目选项里配。排查时先确认报错的单元属于哪个组件或哪个平台然后检查对应的库路径是否包含该单元所在目录。跨平台开发时尤其容易出问题因为不同平台的库路径是分开配置的。我的经验是装完 Delphi 后先不要急着改库路径先用默认配置跑通一个空项目确认默认路径是对的再在此基础上增量添加自己的路径。这样出问题时容易定位是默认配置的问题还是自己改出来的问题。5.3 与杀毒软件的持续冲突前面提过安装时要关杀毒但真正的坑在于编译阶段。Delphi 编译时会频繁读写临时文件和生成可执行文件某些杀毒软件的实时防护会把这些行为判定为可疑导致编译变慢甚至失败。解决办法是把以下目录加入杀毒软件白名单Delphi 安装目录项目所在目录系统临时目录%TEMP%编译输出目录通常在项目下的Win32\Debug之类这件事做一次后面能省掉大量莫名其妙的编译失败。6. 从旧版本迁移到 Delphi 13 的实操建议6.1 迁移前的项目备份与兼容性评估从 Delphi 7、10.2、11 迁移到 13第一步永远是完整备份原项目包括源码、资源文件、第三方组件、编译配置。备份不是复制一份就完事而是要确认备份能独立编译通过作为迁移失败的退路。兼容性评估的重点是第三方组件。很多老组件在新版本 Delphi 上要么不兼容要么需要更新版本。评估方法是列出项目用到的所有第三方组件逐个确认是否有支持 Delphi 13 的版本。没有的话要么找替代方案要么考虑是否值得迁移。6.2 字符串与编码的迁移处理前面提过编码问题这里展开说。Delphi 2009 之后字符串默认是 Unicode从更早版本迁移时string类型的行为变了。旧代码里如果有大量PChar、AnsiString的混用迁移后可能出现乱码或内存问题。处理策略是先让项目能编译通过再逐个处理编码相关的警告和错误。编译器给出的 Unicode 相关警告不要忽略它们往往指向真正的隐患。对于确实需要 ANSI 的场景显式使用AnsiString或RawByteString不要依赖默认行为。6.3 第三方组件的重新安装与路径调整第三方组件在迁移后需要重新安装到 Delphi 13 里。安装组件包时注意以下几点组件包的源码路径不要有中文。安装后确认组件面板上能看到对应组件。如果组件依赖特定的运行库或 DLL确认这些依赖在新环境下也能找到。热词里提到的qtintf70.dll这类 DLL 包含问题本质上是部署时运行库的打包问题。开发阶段组件能跑不代表发布后能跑因为发布机器上可能没有这些 DLL。解决办法是在项目里把这些 DLL 作为资源包含进去或者随程序一起分发。这部分内容展开会很长这里先点到为止核心是开发环境跑通只是第一步部署环境的依赖要单独验证。7. 我踩过的几个真实坑与对应解法第一个坑是在线安装器装到一半网络断了结果 IDE 能打开但 Android 编译器缺失。当时没注意直到切换平台编译才报错。后来改用离线 ISO 重装一次通过。教训是大体积开发工具的安装优先选离线包。第二个坑是补丁装了但没生效。我以为装完补丁程序就完事了结果版本号一直没变。后来才发现补丁装完后需要重启 IDE 并触发一次更新检查。这个细节官方文档里写得不显眼但很关键。第三个坑是杀毒软件导致编译随机失败。表现是同一个项目有时候编译通过有时候报奇怪的链接错误。排查了很久才定位到是杀毒软件的实时防护在拦截。加了白名单之后问题再没出现过。第四个坑是旧项目迁移时的编码混乱。项目里文件编码不统一编译出来的中文全是乱码。后来统一转成 UTF-8 才解决。这件事让我养成了一个习惯接手任何旧项目先检查文件编码。8. 关于 Delphi 13 安装这件事的几句实在话装 Delphi 13 这件事说难不难说简单也不简单。它不像装个普通软件那样一路下一步就完事中间涉及安装包选择、组件勾选、补丁顺序、环境配置、编码设置、杀毒白名单这一连串环节任何一个环节出问题都会让你卡住。我的核心建议就三条用离线 ISO、装最小可用集、装完先跑空项目验证。这三条做到了绝大部分安装问题都能避开。剩下的那些偶发问题靠看日志、查路径、加白名单基本都能解决。至于从旧版本迁移心态上要放平——迁移不是一次就能完美的事先让项目能编译再逐步处理警告和兼容性问题比追求一步到位更现实。Delphi 13 本身是个成熟的工具安装和迁移中遇到的绝大多数问题都是环境配置问题而不是工具本身的问题。把环境理顺了后面开发就顺了。