Delphi远程调试含自定义运行时包的VCL程序提示bpl未找到

这个报错的核心原因是：Delphi 远程部署的自动依赖扫描默认只会收录IDE正式注册的官方运行时包，手动将自定义bpl复制到公共BPL目录的操作，不会把文件加入自动部署的待检索清单，所以部署流程扫不到你的MSTools280.bpl。

按以下步骤配置即可解决：

• 打开主VCL项目，点击顶部菜单 Project -> Deployment 打开部署配置面板，在面板顶部的配置下拉框，选中你当前使用的Win32远程调试对应配置，不要选成本地Debug/Release配置。
• 点击面板上的Add Files按钮，浏览到MSTools280.bpl的实际存放路径（优先选择自定义包项目的原始编译输出目录，不要选你手动复制到公共BPL目录的副本，避免版本不一致），将该bpl添加到部署文件列表。
• 在部署列表中找到刚添加的MSTools280.bpl条目，将它的Remote Directory属性设置为和其他官方运行时包完全一致的远程路径，通常是目标机上exe同级目录，或者paserver默认的运行时包存放目录，和其他已自动收录的bpl路径保持一致即可。
• 如果需要断点调试自定义包内的代码，找到同路径下的MSTools280.rsm调试符号文件，按同样方式加入部署列表，远程路径和对应bpl保持一致即可。
• 全局配置校验：打开 Tools -> Options -> Language -> Delphi -> Library，选中Win32平台配置，确认你自定义包的编译输出目录已经加入Library Path列表，避免后续编译时IDE检索不到包依赖。

注意事项 #

不要尝试靠把自定义bpl复制到IDE公共BPL目录解决部署问题：Delphi自动部署的依赖清单来自项目编译时生成的依赖记录+IDE已注册安装的包列表，未走IDE组件安装流程注册的自定义包，就算放到官方目录也不会被自动识别部署。
如果你的自定义包存在多层依赖（比如MSTools依赖其他你自己写的底层bpl），要按依赖层级从最底层的包开始依次加入部署列表，漏加任意一个依赖包都会触发同类报错。
确认加入部署列表的bpl是Win32 Debug版本，和主项目的编译平台、配置完全匹配，不要混入Win64或者Release版本的文件。

配置完成后重新启动远程调试，部署流程会自动把你手动添加的自定义包传到目标机，不会再报文件找不到的错误，包内设置的断点也可以正常命中。

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