本文覆盖常规同盘项目与跨盘依赖项目两种使用场景同时包含「依赖清单在线安装」与「完整依赖文件夹打包」两种依赖处理方案可根据实际情况选择。一、标准方案依赖清单在线安装推荐这是 Docker 通用最佳实践不复制本地虚拟环境或完整依赖文件夹仅通过依赖清单文件如 Python 的 requirements.txt在镜像构建时自动在线安装依赖生成的镜像体积小、跨平台兼容性强。1.1 常规同盘场景项目与依赖清单在同一目录适用于项目代码与依赖清单都在同一盘符、同一项目目录下的普通场景。目录结构Plain TextC:\my-project\ # 项目根目录├── A/ # 项目代码文件夹│ └── main.py # 程序入口├── requirements.txt # 依赖清单文件└── DockerfileDockerfile 编写dockerfile# 选择基础运行环境FROM python:3.10-slim# 设置容器内工作目录WORKDIR /app# 复制项目代码COPY A /app/A# 复制依赖清单文件COPY requirements.txt /app/requirements.txt# 在线安装依赖RUN pip install --no-cache-dir -r requirements.txt# 容器启动命令CMD [python, A/main.py]构建镜像在项目根目录打开终端执行powershellcd C:\my-projectdocker build -t my-project:v1 .1.2 跨盘场景依赖清单在其他盘符如果 requirements.txt 不在项目目录而在其他盘符如 D:\libs\requirements.txt有两种处理方式方式 1复制清单到项目目录最简单将其他盘符的 requirements.txt 复制到项目根目录后续操作与 1.1 完全一致。方式 2多构建上下文不移动文件使用 Docker BuildKit 多上下文功能直接读取跨盘的依赖清单dockerfileFROM python:3.10-slimWORKDIR /appCOPY --fromproject . /app/ACOPY --fromdeps requirements.txt /app/requirements.txtRUN pip install --no-cache-dir -r requirements.txtCMD [python, A/main.py]构建命令powershelldocker buildx build --build-context projectC:/my-project/A --build-context depsD:/libs -t my-project:v1 -f Dockerfile .二、离线方案打包完整依赖文件夹特殊依赖适用适用于依赖无法在线安装、需要离线运行或依赖文件夹包含二进制 SDK、模型文件等特殊场景。2.1 常规同盘场景如果依赖文件夹与项目在同一盘符、同一上级目录下直接在 Dockerfile 中复制即可。目录结构Plain TextC:\my-project\├── A/ # 项目代码├── B/ # 依赖文件夹└── DockerfileDockerfile 编写dockerfileFROM python:3.10-slimWORKDIR /appCOPY A /app/ACOPY B /app/BRUN pip install --no-cache-dir -r B/requirements.txtCMD [python, A/main.py]2.2 跨盘场景依赖在其他盘符Docker 构建时有「构建上下文」规则只能读取命令执行目录及其子目录内的文件无法直接读取其他盘符 / 上级目录的文件需先统一目录结构。步骤 1整理目录结构找到项目根目录例如C:\my-project\存放代码文件夹A找到其他盘符的依赖文件夹例如D:\libs\B将整个B文件夹复制到C:\my-project\下最终结构与 2.1 一致Plain TextC:\my-project\├── A/│ └── main.py├── B/│ └── requirements.txt└── Dockerfile步骤 2创建 .dockerignore 优化体积可选在项目根目录新建.dockerignore文件排除无用文件大幅减小镜像大小Plain Text.git.venvnode_modules*.log__pycache__.vscode.idea步骤 3构建镜像powershellcd C:\my-projectdocker build -t my-project:v1 .参数说明-t my-project:v1给镜像命名并标记版本末尾的.代表以当前目录作为构建上下文绝对不能省略构建完成后执行docker images列表中出现my-project:v1即为成功。三、镜像导出与分享方式 1本地文件传输无需账号导出镜像powershelldocker save -o my-project-v1.tar my-project:v1执行后项目根目录生成my-project-v1.tar将该文件发送给朋友即可。朋友导入并运行前置准备朋友电脑需安装 Docker DesktopWindows/Mac或 Docker 引擎Linux。导入镜像powershelldocker load -i my-project-v1.tar执行docker images能看到对应镜像即为导入成功。启动容器普通命令行 / 脚本项目powershelldocker run --rm my-project:v1Web / 接口服务项目需端口映射容器内端口以 8080 为例powershelldocker run -d -p 8080:8080 --name my-app my-project:v1参数说明-d后台静默运行-p 8080:8080本地 8080 端口映射到容器内 8080 端口--name my-app给容器命名便于管理验证运行命令行项目查看终端输出Web 项目浏览器访问http://localhost:8080方式 2云端仓库分享适合多次分享注册并登录 Docker Hubpowershelldocker login给镜像打标签替换为你的 Docker Hub 用户名powershelldocker tag my-project:v1 你的用户名/my-project:v1推送镜像到云端powershelldocker push 你的用户名/my-project:v1朋友直接拉取运行powershelldocker pull 你的用户名/my-project:v1docker run -d -p 8080:8080 你的用户名/my-project:v1四、备选挂载方案运行时挂载依赖适合 GB 级大体积依赖如果依赖体积很大如 AI 模型、大型 SDK不想打进镜像导致文件过大可使用「镜像仅打包代码 运行时挂载依赖」的方案。你这边的操作Dockerfile 仅打包项目代码dockerfileFROM python:3.10-slimWORKDIR /appCOPY A /app/ACMD [python, A/main.py]构建镜像并导出 tar 包将「镜像 tar 包」和「依赖文件夹压缩包」一并发给朋友朋友那边的操作解压依赖文件夹到本地任意路径例如D:\deps\B导入镜像启动容器时添加挂载参数powershelldocker run -d -p 8080:8080 -v D:/deps/B:/app/B my-project:v1格式规则-v 本地依赖绝对路径:容器内依赖路径容器内的路径/app/B必须和代码中读取依赖的路径完全一致否则会出现依赖找不到的错误。五、常见问题排查构建报错「找不到文件」检查依赖文件 / 文件夹是否在构建上下文目录内确认 Dockerfile 中路径拼写正确。运行提示找不到依赖挂载方案请核对容器内路径与代码读取路径是否完全匹配自包含方案请检查 Dockerfile 中 COPY 路径与依赖安装命令是否正确。Web 项目无法访问检查端口映射参数是否正确确认本地端口未被其他程序占用。