如何在GitLab-runner上交叉编译.NET项目生成Windows可运行的EXE文件

• 你使用的mcr.microsoft.com/dotnet/sdk:5.0是Linux环境SDK，默认dotnet publish无额外参数时，生成的是框架依赖型跨平台部署包，仅生成.dll入口文件，不会生成Windows专属.exe文件，需要目标机器安装对应.NET Runtime后通过dotnet xxx.dll启动。
• 你的项目配置了多目标框架（.csproj中是TargetFrameworks节点而非单TargetFramework节点），发布时必须明确指定目标框架和运行时环境，才能生成对应平台的可执行文件。
• 之前报NETSDK1005错误的原因是：你之前的restore操作是针对Linux运行时默认执行的，没有生成你指定的net5.0+Windows目标的依赖资产，不需要单独提前执行restore，publish时会自动针对指定参数完成对应restore操作。

1. 先确认可执行项目的.csproj文件中的<TargetFrameworks>节点配置，记下你需要发布的目标框架版本（比如net5.0）。
2. 调整deploy_job中的publish命令，添加运行时指定参数：
   • 要生成Windows x64环境的可执行文件，指定运行时为win-x64（32位系统替换为win-x86）
   • 如果目标Windows机器已安装.NET 5.0 Runtime，添加--self-contained false，产物体积更小
   • 如果目标机器未安装Runtime，添加--self-contained true，会将Runtime一同打包，产物可直接双击运行
   • 如需生成单EXE文件，额外添加-p:PublishSingleFile=true参数
3. 修改后的.gitlab-ci.yml的deploy阶段参考配置：

deploy_job:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  script:
    # 替换下方net5.0为你的项目实际目标框架，win-x64根据需要替换为对应的Windows架构
    - dotnet publish MyProject.sln -f net5.0 -r win-x64 --self-contained false -o ../publish
    # 后续执行sftp拷贝../publish目录到Windows目标机器即可

4. 现有build、test阶段配置无需改动，build阶段生成的跨平台产物可正常被test阶段复用，和deploy阶段生成Windows专属产物互不冲突。

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