docker commit 的本质是为容器文件系统状态拍快照，仅固化可写层变更（如软件安装、配置修改），不保存内存、进程或网络状态，适合调试、救急和教学，但因不可追溯、不可重复，不宜用于正式交付。
掌握 docker commit 的关键不是死记命令，而是理解它“拍快照”的本质——把容器当前的文件系统状态（含你装的软件、改的配置、新增的文件）固化成一个可复用的新镜像。它不记录过程，只保存结果，所以适合调试、救急、教学，但不适合正式交付。
确认容器状态并做好提交准备
先运行 docker ps -a 列出所有容器，找到目标容器的 ID 或名字。确保你在里面已完成全部修改：比如装好了 nginx、替换了 /usr/share/nginx/html/index.html、设置了环境变量等。
- 容器可以是运行中，也可以是已停止；运行中提交会捕获那一刻已落盘的文件，不包含内存数据
- 建议提前
docker exec -it <容器名> bash进去检查路径、权限、内容是否符合预期 - 务必清理敏感信息：删掉临时密码文件、注释掉配置里的密钥、清空日志或缓存目录
- 记下容器名（如
my-app-dev），后面命令要用
执行 commit 命令并添加必要元数据
最简命令是 docker commit my-app-dev my-app:v1，但推荐加上说明和作者，便于追溯：
-
-m "Add Redis client and custom config"—— 描述这次改了什么 -
-a "dev-team@company.com"—— 标明责任人 -
--change 'CMD ["python", "app.py"]'—— 覆盖默认启动命令（避免沿用原镜像 CMD） -
-p参数可选：提交前自动暂停容器，提升文件一致性（尤其对写入频繁的服务）
完整示例：docker commit -m "Install curl + update nginx conf" -a "ops@demo.org" -p --change 'CMD ["nginx", "-g", "daemon off;"]' my-nginx nginx-prod:v2026
验证新镜像是否可用且符合预期
提交后立即执行 docker images，确认新镜像出现在列表中。接着快速验证功能与元数据：
- 运行测试容器：
docker run -d -p 8080:80 --name test-v2026 nginx-prod:v2026 - 访问
http://localhost:8080看自定义页面是否生效 - 执行
docker inspect nginx-prod:v2026，检查Author、Comment、Config.Cmd是否正确写入 - 用
docker history nginx-prod:v2026查看镜像层结构，辅助判断是否有多余大文件或可疑层
知道什么时候不该用 commit
commit 是应急工具，不是构建规范。以下情况应直接改用 Dockerfile：
- 需要多人协作或 CI/CD 自动构建
- 要求每次构建结果完全一致（commit 依赖容器当时状态，不可控）
- 镜像要长期维护、打补丁、做安全扫描
- 基础镜像升级后，无法一键同步到你的定制镜像
如果已经用了 commit，可以用 docker history 和 docker inspect 反推大致结构，再补写 Dockerfile —— 这才是走向可维护的正确路径。
