注释是Dockerfile可维护性的关键，需说明意图而非重复指令，用结构化区块划分阶段，敏感操作须附警示且紧贴对应指令。
注释不是可有可无的装饰，而是 Dockerfile 可维护性的关键一环。它不参与构建，但直接影响团队协作效率、问题定位速度和后续迭代成本。好的注释让别人（包括三个月后的你自己）一眼看懂“为什么这么写”，而不只是“写了什么”。
注释要说明意图，而不是重复指令
避免写“COPY requirements.txt /tmp/”后面跟一句“复制 requirements 文件”——这毫无信息增量。真正有用的是解释背后的逻辑：
- 说明依赖分离原因：
- 解释版本锁定目的：
- 标注安全考量：
在关键分界点添加结构化注释
Dockerfile 是线性执行的脚本，但实际逻辑常分阶段。用清晰的注释块划分功能区域，能快速定位上下文：
- 基础环境准备段开头：# === BASE SETUP ===
- 依赖安装段开头：# === DEPENDENCIES ===
- 应用代码部署段开头：# === APPLICATION CODE ===
- 运行时配置段开头：# === RUNTIME CONFIGURATION ===
这类注释不追求花哨，统一用等号或破折号分隔即可，重点是视觉上形成区块感。
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
敏感操作必须附带警示注释
有些指令一旦出错影响大，比如清理缓存、删除临时文件、修改权限。它们容易被误删或忽略，需显式提醒：
注释位置要紧贴对应指令，且保持缩进一致
注释应写在所解释指令的正上方（或同一行末尾），不要空行隔开；多行指令中，注释放在第一行之前：
# 安装构建依赖并立即清理，减少镜像层数和体积
RUN apt-get update && apt-get install -y build-essential \
&& pip install --no-cache-dir cython \
&& rm -rf /var/lib/apt/lists/*
如果注释放在中间或错位，容易让人误判作用范围，尤其在合并多个命令的 RUN 中更需谨慎。
