Docker容器执行dotnet --version提示命令未找到的原因排查

1. 镜像采用了独立发布的runtime-deps基础镜像 #

Visual Studio给.NET应用添加Docker支持时，默认可能生成两种镜像配置：一种是包含SDK的开发镜像（用于调试），另一种是仅包含运行依赖的生产镜像（独立发布模式，不含.NET SDK甚至Runtime）。如果你的core6apiconsoleclient:dev镜像属于后者，容器内只会有编译好的可执行文件，自然不存在dotnet命令。

你可以查看Dockerfile中的基础镜像声明，如果是FROM mcr.microsoft.com/dotnet/runtime-deps:8.0，就属于这种情况——该镜像仅能运行编译后的程序，不包含SDK和dotnet命令。

2. 多阶段构建仅保留了运行产物 #

很多Dockerfile会采用多阶段构建：第一阶段用SDK镜像编译代码，第二阶段将编译好的程序复制到轻量的runtime镜像中。典型结构如下：

# 第一阶段：使用SDK镜像编译代码
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY . .
RUN dotnet publish -c Release -o /app/publish

# 第二阶段：使用runtime-deps镜像运行程序
FROM mcr.microsoft.com/dotnet/runtime-deps:8.0 AS final
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["./core-6-api-console-client"]

这种情况下，最终生成的core6apiconsoleclient:dev镜像来自final阶段，不包含SDK，因此找不到dotnet命令。

3. 镜像标签出现混淆 #

你看到的core6apiconsoleclient:dev可能并非带SDK的开发镜像，而是生产环境的runtime镜像。可以执行docker inspect core6apiconsoleclient:dev，查看输出中的基础镜像信息，确认它是基于SDK还是runtime类型构建的。

4. 环境变量配置异常（概率较低） #

如果镜像确实基于SDK但仍找不到dotnet命令，可进入容器后执行echo $PATH，检查路径中是否包含/usr/share/dotnet（Linux容器）或对应Windows路径。不过官方SDK镜像会自动配置好PATH，这种情况很少见。

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