| 报错 | invalid reference format |
|---|---|
| 高频触发 | shell 变量为空 / 名字里有空格或大写 |
| 规范 | 仓库/命名空间/名称:标签 全小写 |
示例
示例
TAG=1.0; docker build -t app/web:$TAG .
# 调试：打印真实命令值
echo "docker build -t app/web:$TAG ."
docker pull ${IMAGE:-app/web:1.0}镜像名规范：小写字母数字与 ._-/:，别混入空格与反斜杠。
invalid reference format 定位
镜像名解析失败：命名含非法字符、变量为空导致 -t 后面缺值、参数顺序错误、Windows 路径写法混入等。
易错点
- CI 变量未注入时 $TAG 为空，错误信息里只显示冒号后的空值，容易看漏
- 把宿主路径（带盘符或反斜杠）当镜像名传给 -t 也会触发同类错误
数据来源与参考
- Docker 官方文档：Image name reference 规范（docs.docker.com）