docker build -f 参数指定 Dockerfile 路径时，该路径必须相对于构建上下文（命令末尾的 . 或 ./path），而非 shell 当前目录；Docker 无法访问上下文外文件，否则报错“path not found”或 COPY 失败。
docker build -f 参数必须配合正确的构建上下文路径
直接写 docker build -f /absolute/path/Dockerfile . 会失败，因为 -f 后的路径是相对于构建上下文（即命令末尾那个 . 或 ./path 所指目录）的，不是 shell 当前工作目录。Docker 不会、也不能读取上下文外的文件。
常见错误现象：unable to prepare context: path "/absolute/path/Dockerfile" not found 或构建时 COPY 报错找不到源文件。
- 先确认 Dockerfile 在你要设为上下文的目录里，比如
./build/Dockerfile.prod - 运行
docker build -f build/Dockerfile.prod .：上下文是当前目录.，-f路径就写相对.的子路径 - 如果 Dockerfile 在上层目录，且你希望把上层作为上下文，就用
docker build -f configs/Dockerfile.dev .. - 不要把
-f和上下文路径搞反——docker build -f ./Dockerfile .和docker build -f Dockerfile .效果一样，但前者容易误导人以为路径是相对 shell 目录
Docker Desktop 里没有单独的“Dockerfile 路径设置”界面
Docker Desktop 本身不提供图形化入口去全局指定默认 Dockerfile 名称或位置。它只是调用 CLI，所有构建逻辑完全由 docker build 命令控制。你在 Desktop 的 “Containers / Apps” 或 “Images” 标签页里点 “Build image”，背后仍是执行 CLI 命令，所以必须显式传 -f。
使用场景：CI/CD 配置、本地调试多环境镜像、IDE 插件触发构建（如 VS Code Docker 扩展）——它们最终都拼出带 -f 的命令行。
- VS Code Docker 扩展构建时，会在
.devcontainer/devcontainer.json里配"dockerFile": "./Dockerfile.dev"，它会自动转成docker build -f ./Dockerfile.dev . - Docker Desktop 的 “Quick Start” 或右键菜单“Build Image”默认只认
Dockerfile，不支持选文件；真要换，得打开终端手动敲命令 - 如果你用 Docker Compose，
docker-compose.yml中的build:可以指定context和dockerfile字段，例如：build:<br> context: .<br> dockerfile: docker/nginx.Dockerfile
这等价于 CLI 的docker build -f docker/nginx.Dockerfile .
构建上下文范围决定 COPY/ADD 能访问哪些文件
-f 只告诉 Docker 哪个文件是构建脚本，不影响构建过程中能读取的文件范围。所有 COPY、ADD 指令的源路径，只能是构建上下文目录及其子目录里的内容。
容易踩的坑：把 Dockerfile 放在 ./ci/Dockerfile.builder，然后运行 docker build -f ci/Dockerfile.builder .，结果 COPY ../src/ . 失败——因为 ../src/ 不在上下文 . 内。
- 正确做法：把需要复制的代码、配置、证书等，全部放进上下文目录（如
./src、./config），再用相对路径引用 - 或者调整上下文：比如把上下文设为项目根目录
..，再写docker build -f ci/Dockerfile.builder ..，这时COPY src/ .就合法了 -
.dockerignore文件也只对上下文内文件生效，它不能屏蔽-f指定的 Dockerfile 本身
多阶段构建中 -f 和 --target 要配合使用
当一个 Dockerfile 包含多个 FROM 阶段（比如 builder + runtime），而你只想构建其中某一段，就得靠 --target。但它必须和 -f 一起用，否则 Docker 不知道该去哪找那个带多阶段的文件。
典型场景：前端项目用 Node 阶段构建静态资源，再 COPY 到 Nginx 阶段；后端用 Maven 编译 Java，再提取 jar 到 Alpine 运行时。
- 命令示例：
docker build -f Dockerfile.multi -t myapp:build --target builder . -
--target的值必须是 Dockerfile 中某个FROM ... AS xxx的xxx名，大小写敏感 - 如果没加
--target，Docker 默认构建最后一个阶段；加了但名字错，会报错stage xxx was not found - 注意：即使你只构建 builder 阶段，所有
COPY指令仍受限于上下文——比如COPY package.json .要求package.json在上下文里
-f 不等于改“能读什么”，真正管文件可访问性的，永远是那个点号（.）或路径参数。 
