GitLab CI/CD搭配.NET入门遇问题：dotnet命令未找到

核心问题 #

你指定的Docker镜像只在**Docker执行器（或Kubernetes执行器）**下才会生效，但你的Job实际用了Shell执行器——Shell执行器直接在GitLab Runner所在的宿主机环境跑命令，不会拉取你配置的镜像，宿主机没装dotnet自然就找不到命令。

原因拆解 #

• Shell执行器的工作逻辑：它直接调用Runner所在服务器的系统Shell执行脚本，完全复用宿主机的所有环境变量和已安装软件，不会启动任何容器，所以CI脚本里的image配置对它来说是无效的。
• Docker执行器才会根据你指定的image拉取镜像，在独立的容器内部执行Job，这样才能用到镜像里预装好的dotnet环境。

解决办法 #

方法1：切换为Docker执行器 #

• 先确认你的GitLab Runner配置：查看Runner的config.toml文件，检查executor字段是否为docker。
• 如果是公司自建环境，联系运维团队调整现有Runner的执行器类型，或者新增一个使用Docker执行器的Runner。
• 调整后，你的CI脚本里的image配置会正常生效，Job会在mcr.microsoft.com/dotnet/sdk:latest容器内执行dotnet命令。

方法2：在Shell执行器的宿主机安装dotnet #

• 如果没法切换执行器，就需要在Runner所在的宿主机上手动安装.NET SDK，这样Shell执行器就能找到dotnet命令。
• 按照.NET官方的安装指引，在宿主机部署对应版本的.NET SDK即可。

方法3：临时在CI脚本中安装dotnet（不推荐） #

• 可以在Job脚本里加入dotnet的安装命令，比如：

  # 示例：安装.NET 6 SDK（可根据需求调整版本）
  wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  apt-get update && apt-get install -y dotnet-sdk-6.0
  

• 这种方法每次Job都要重复安装，耗时耗资源，只适合临时应急。

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