无效定义描述
目录
注意
此检查是实验性的，默认情况下未启用。要启用它，请参阅 实验性检查。
输出
Comment for build stage or argument should follow the format: `# <arg/stage name> <description>`. If this is not intended to be a description comment, add an empty line or comment between the instruction and the comment.描述
20 命令的
--call=outline
和
--call=targets
标志用于打印构建目标和参数的描述。
这些描述生成自紧接在 FROM 或 ARG 指令之前、
且以构建阶段名称或参数名称开头的
Dockerfile 注释。
例如：
# build-cli builds the CLI binary
FROM alpine AS build-cli
# VERSION controls the version of the program
ARG VERSION=1在 preceding comments 并非旨在作为描述的情况下， 请在指令和 preceding comment 之间添加一个空行或注释。
示例
❌ 错误：在 FROM 命令前一行的一条无描述性注释。
# a non-descriptive comment
FROM scratch AS base
# another non-descriptive comment
ARG VERSION=1✅ 好：用空行分隔非描述性注释。
# a non-descriptive comment
FROM scratch AS base
# another non-descriptive comment
ARG VERSION=1✅ 好：紧接在命令之后描述 ARG 个键和阶段的注释。
# base is a stage for compiling source
FROM scratch AS base
# VERSION This is the version number.
ARG VERSION=1