Dockerfile 语法声明 # syntax

文件首行的 # syntax=docker/dockerfile:1 声明使用哪个前端解析器版本，启用 heredoc、RUN --mount 等较新的构建语法。

用途	固定 Dockerfile 语法前端版本
写法	# syntax=docker/dockerfile:1（必须位于文件首行）
归属	BuildKit 前端机制

示例

# syntax=docker/dockerfile:1
FROM node:20-alpine
WORKDIR /app
RUN --mount=type=cache,target=/root/.npm npm ci

写 :1 表示使用最新 1.x 前端；不写则用引擎内置版本，老引擎可能不支持 --mount 与 heredoc。

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌