CodeGeeX 可一键生成生产就绪 Dockerfile：需启用最新版插件，确保项目含启动文件/依赖清单，支持右键、自然语言或终端命令触发生成，并须校验基础镜像、COPY顺序、HEALTHCHECK及CMD指令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想把本地 Python 脚本一键封装成 Web 服务，但每次都要手动写 Dockerfile、配依赖、设端口、加健康检查——重复劳动太耗时间。CodeGeeX 能直接基于你的代码结构和运行需求，生成语义准确、可直接构建的 Dockerfile，跳过查文档、试镜像、调路径的环节。
确认 CodeGeeX 插件已就位
打开 VSCode → 左侧扩展图标 → 搜索 CodeGeeX → 确认已安装且状态为“已启用”。若未安装，点击“安装”，完成后重启 VSCode。
这一步不能跳过：CodeGeeX 的 Dockerfile 生成能力依赖其最新版语言模型理解能力，【旧版本插件（v2.3.0 之前）不支持 Dockerfile 语义推导】。
准备上下文：让 CodeGeeX 看懂你的项目
在 VSCode 中打开你的项目根目录，确保以下至少一项存在：
- 一个可运行的启动文件（如
main.py、app.py或server.js） - 已存在的
requirements.txt或package.json - 明确的运行命令（例如终端里你常敲的
python main.py或uvicorn app:app）
没有这些，CodeGeeX 只能猜——它会默认用 Python 3.11 + pip 安装 + CMD python app.py，很可能不符合你的真实环境。
触发 Dockerfile 生成
方法一：右键菜单快捷生成
在项目根目录空白处右键 → 选择 CodeGeeX → Generate Dockerfile → 弹出输入框后，直接回车（默认提示词已预置为：“根据当前项目结构、依赖文件和启动方式，生成生产就绪的 Dockerfile，多阶段构建，基础镜像精简，WORKDIR 合理，COPY 顺序优化，EXPOSE 正确端口”）。
方法二：自然语言指令生成
选中你的主入口文件（如 main.py）→ 按 Ctrl+I（Windows/Linux）或 Cmd+I（macOS）唤出 CodeGeeX 输入框 → 输入：“生成适用于 FastAPI 应用的 Dockerfile，使用 python:3.10-slim，非 root 用户运行，暴露 8000 端口，添加 HEALTHCHECK，COPY 时排除 .git 和 __pycache__” → 回车。
方法三：终端命令式生成（推荐用于 CI/CD 场景）
打开 VSCode 内置终端 → 运行：codgeex generate dockerfile --context ./ --framework fastapi --port 8000 --user nonroot。该命令会自动读取 requirements.txt 并注入 RUN addgroup -g 1001 -f app && adduser -S app -u 1001 等安全配置。
校验与微调关键字段
第一步：检查基础镜像是否匹配 runtime。
生成的 Dockerfile 第一行应为类似 FROM python:3.10-slim。若你项目依赖 CUDA 或 PyTorch，需手动改为 FROM nvidia/cuda:12.2.0-devel-ubuntu22.04 并补全 pip install torch torchvision；否则构建时会因缺失 libcuda.so 失败。
第二步：确认 WORKDIR 和 COPY 顺序。
必须先 COPY requirements.txt . → RUN pip install -r requirements.txt → 再 COPY . .，否则 Docker 缓存失效，每次构建都重装全部依赖。
第三步：验证 HEALTHCHECK 是否生效。
检查是否存在形如 HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD curl -f http://localhost:8000/health || exit 1 的行。没有这行，Kubernetes 就无法判断容器是否真正就绪。
第四步：检查 CMD 是否指向可执行入口。
若你用的是 Uvicorn，CMD 应为 ["uvicorn", "main:app", "--host", "0.0.0.0:8000", "--reload"]；若删掉 --reload，则必须同步删掉 dev-dependencies 相关包，否则生产镜像体积膨胀 3 倍以上。
