在现代软件开发中，容器化已经成为交付应用的标准方式之一。对于使用 .NET 技术栈的开发者而言，将项目打包成 Docker 镜像不仅能够提升部署效率，还能保证环境一致性，避免“在我机器上能跑”的尴尬局面。本文将带你一步步完成从 .NET 项目到 Docker 镜像的全过程，适用于 .NET 6、.NET 7 或更高版本的项目。

首先，确保你的开发环境中已安装 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），并确认 docker 命令可在终端中正常使用。同时，准备好一个已开发完成的 .NET 项目，比如一个简单的 Web API 或后台服务程序。

接下来，在项目根目录下创建一个名为 Dockerfile 的文件（无后缀名）。这个文件是 Docker 构建镜像的核心配置脚本，它定义了镜像的构建步骤。以一个典型的 ASP.NET Core 项目为例，Dockerfile 内容如下：

dockerfile

使用官方 SDK 镜像作为构建阶段的基础镜像

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app

将项目文件复制到容器中

COPY *.csproj ./
RUN dotnet restore

复制其余源码并发布应用

COPY . ./
RUN dotnet publish -c Release -o out

运行阶段：使用更轻量的 runtime 镜像

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
WORKDIR /app
COPY --from=build /app/out .

设置启动入口

ENTRYPOINT ["dotnet", "YourProjectName.dll"]

这里采用了多阶段构建（multi-stage build）策略，先用 SDK 镜像完成编译和发布，再将输出结果复制到仅包含运行时环境的轻量镜像中。这样做可以显著减小最终镜像的体积，提升安全性和部署速度。

需要注意的是，YourProjectName.dll 应替换为你的实际程序集名称，通常与 .csproj 文件同名。例如，若项目名为 MyApi.csproj，则此处应写 MyApi.dll。

完成 Dockerfile 编写后，打开终端，进入项目根目录，执行以下命令构建镜像：

bash docker build -t my-dotnet-app:latest .

其中 -t 参数用于指定镜像名称和标签，. 表示上下文路径为当前目录。构建过程会依次执行 Dockerfile 中的指令，拉取基础镜像、恢复依赖、编译代码并生成最终镜像。

构建成功后，可通过 docker images 查看本地镜像列表，确认 my-dotnet-app 已存在。接着运行容器：

bash docker run -d -p 5000:80 --name myapp-container my-dotnet-app

该命令以后台模式启动容器，并将主机的 5000 端口映射到容器内的 80 端口（.NET 默认监听端口）。如果应用正常运行，访问 http://localhost:5000 即可看到接口响应。

在实际生产环境中，还需考虑更多细节。例如，使用 .dockerignore 文件排除不必要的文件（如 bin/、obj/、.git 等），避免污染构建上下文；配置环境变量支持不同部署环境；结合 Nginx 实现反向代理和 HTTPS；或将镜像推送到私有仓库如 Azure Container Registry 或 Harbor。

此外，Docker 化后的 .NET 应用更容易集成进 CI/CD 流程。无论是 GitHub Actions、Azure DevOps 还是 Jenkins，都可以通过脚本自动化完成镜像构建、测试和部署，极大提升交付效率。

总而言之，将 .NET 项目打包成 Docker 镜像是迈向现代化架构的重要一步。它不仅简化了部署流程，还为后续的微服务拆分、弹性伸缩和跨平台运行打下坚实基础。只要掌握 Dockerfile 的编写逻辑和构建机制，任何 .NET 开发者都能快速上手容器化实践。