运行WixSharp Managed Setup项目报LGHT0103找不到文件错误是什么原因？

你遇到的报错原文如下：

C:\agent\_work\66\s\src\ext\UIExtension\wixlib\Common.wxs(7) : error LGHT0103 : The system cannot find the file

陌生路径来源说明 #

报错信息中提到的C:\agent\_work\66\s\src\ext\UIExtension\wixlib\Common.wxs是Wix官方构建UI扩展包时的服务器端源文件路径，属于报错日志附带的原始编译信息，和你的本地环境无关，不需要纠结该路径是否存在。

错误核心成因 #

• Wix链接器找不到依赖资源：错误码LGHT0103是Wix链接器（light.exe）的典型报错，本质是你项目引用的WixUI_Common UI模板依赖的资源文件没有被正确加载。
• 项目未显式引入WixUIExtension：WixUI_Common属于WixUIExtension扩展模块提供的模板，WixSharp默认不会自动引入该扩展，如果你只指定了UI类型为WixUI_Common、没有在构建配置里声明依赖WixUIExtension，就会触发该报错。你可以在WixSharp项目的构建逻辑中添加project.IncludeWixExtension(WixExtension.UI)验证是否是该问题。
• Wix版本不匹配：如果你本地安装的Wix Toolset版本和当前使用的WixSharp版本依赖的Wix版本不一致，也会出现扩展资源找不到的问题，比如Wix3和Wix4的WixUIExtension引用方式、内置资源路径存在较大差异。

内容的提问来源于stack exchange，提问作者R.P