VS2017中如何为使用NuGet包的WinForms项目生成独立exe文件

高版本VS（2019/2022）运行异常修复 #

• 打开高版本VS加载项目时，所有弹出的项目升级、SDK更新、NuGet包升级提示全部选择不升级，CEFSharp对.NET版本、VC++运行时版本匹配要求极高，自动升级会直接导致版本不兼容崩溃。
• 项目目标框架必须保持和VS2017开发时的配置完全一致，不要随意切换.NET Framework版本号，不要开启「使用最新的C#语言版本」这类自动适配选项。
• 高版本VS默认不会自动拷贝CEFSharp的原生资源文件到输出目录，首次在高版本VS运行前必须手动执行一次重新生成，确保所有依赖项完整。

生成任意位置可直接启动的EXE #

不要用默认的安装向导/ClickOnce打包，这类工具对带原生依赖的第三方包识别率极低，按以下步骤操作：

1. 调整生成配置
   • 顶部工具栏把生成模式切到Release，平台禁止选Any CPU：如果你的CEFSharp是64位版本就选x64，32位版本就选x86，进配置管理器新建对应平台即可，x64模式下要取消项目属性里「首选32位」的勾选。
   • 右键项目进入「属性-生成」页，自定义一个独立的输出路径，不要用默认的bin\Release目录，避免旧缓存文件干扰。
2. 补全依赖复制规则
   • 打开NuGet包管理器，确认CEFSharp.Common、CEFSharp.WinForms、EasyTabs三个包的主版本完全一致，不存在版本冲突。
   • 进入「生成事件」页，在后期生成事件命令行中添加以下命令，确保CEFSharp的原生资源完整复制到输出目录：

     xcopy "$(SolutionDir)packages\CEFSharp.Common.*\CEF\x86\*" "$(TargetDir)x86\" /s /y /i
     xcopy "$(SolutionDir)packages\CEFSharp.Common.*\CEF\x64\*" "$(TargetDir)x64\" /s /y /i
     

     只需要单架构的话可以删掉对应不需要的架构复制命令，缩小最终包体积。

3. 生成可用程序
   • 点击顶部菜单「生成-重新生成解决方案」，等待生成完成后打开你设置的输出文件夹，整个文件夹里的内容就是绿色版程序，拷贝到任意同系统体系的Windows设备上，只要设备安装了和项目目标版本一致的.NET Framework、VC++ 2015-2022运行时，直接点击主EXE即可启动，不需要依赖VS环境。
   • 需要单文件EXE的话，安装Costura.Fody NuGet包，重新生成后会自动把所有托管DLL嵌入主EXE；注意CEFSharp的libcef.dll、资源pak文件不要做内嵌压缩，否则会导致CEF初始化失败。

之前安装向导制作失败的常见原因 #

• VS自带的安装向导不会自动识别CEFSharp的非DLL资源：包括locales语言文件夹、icudtl.dat、cef.pak、chrome_elf.dll等文件，手动添加时漏任意一个都会导致启动黑屏、闪退。
• EasyTabs依赖的WindowsAPICodePack.Shell组件必须用1.1.0.0版本，更高版本会导致自定义标题栏渲染异常、窗口拖拽失效。
• 不要开启项目属性里的「启用ClickOnce安全设置」「Com可见」选项，这两个选项会和CEFSharp的沙箱机制冲突，导致启动直接报错。

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