COPY指令不自动处理跨平台配置差异，需在复制前通过Git设置、dos2unix、统一命名、chmod/--chmod、UTF-8无BOM等手段主动适配换行符、路径大小写、权限和编码问题。
Dockerfile 中的 COPY 指令本身不处理跨平台配置文件的“差异同步”，它只是单向、静态地将宿主机文件或目录复制到镜像中。所谓“跨平台配置差异”（如 Windows 与 Linux 的换行符、路径分隔符、权限、编码等）需在 COPY 前或构建上下文中主动适配，而非 COPY 自动解决。
换行符与文本文件兼容性
Windows 默认使用 CRLF（\r\n），Linux/macOS 使用 LF（\n）。若配置文件（如 .env、nginx.conf、YAML/JSON）在 Windows 编辑后直接 COPY 到 Linux 镜像，可能导致解析失败（例如 shell 脚本执行报错 command not found，因末尾多出 \r）。
- 推荐在 Git 中启用
core.autocrlf=input（Linux/macOS）或core.autocrlf=true（Windows），确保仓库统一存储为 LF - 构建前可用
dos2unix工具批量转换（需在 Dockerfile 中提前安装）：RUN apt-get update && apt-get install -y dos2unix && dos2unix /app/config/*.conf - 或改用
FROM alpine:latest镜像时用tr -d '\r' file.new清理
文件路径与大小写敏感性
Windows/macOS 文件系统默认不区分大小写（App.js 和 app.js 视为同一文件），而 Linux ext4 等文件系统严格区分。若 COPY 指令引用了大小写不一致的路径，Linux 构建会失败（no such file or directory）。
- COPY 源路径必须与宿主机实际文件名完全一致（包括大小写）
- 建议在开发阶段统一使用小写命名 + 连字符（如
database-config.yml），避免依赖大小写 - 可在 CI 流水线中加入校验步骤，例如
ls -l ./config/ | grep -E "(.yml|.env)"确认存在性
文件权限与可执行性
Windows 不支持 Unix 权限位（如 chmod +x），COPY 后的脚本在 Linux 容器中默认无执行权限，直接 RUN ./entrypoint.sh 会报错 Permission denied。
- 在 Dockerfile 中显式设置权限：
RUN chmod +x /app/entrypoint.sh - 或使用
COPY的--chmod参数（Docker 20.10+）：COPY --chmod=755 entrypoint.sh /app/entrypoint.sh - 注意：该参数仅适用于单个文件，对目录无效；且不会改变宿主机文件权限
编码与特殊字符处理
Windows 记事本常保存为 GBK 或 UTF-8 with BOM，而多数 Linux 工具（如 jq、python -c "import json"）要求纯 UTF-8 无 BOM。含 BOM 的 JSON/YAML 可能导致解析失败。
- 编辑器统一设为 “UTF-8 without BOM”（VS Code、Notepad++、Sublime 均可配置）
- 构建时用
iconv或sed清除 BOM：RUN sed -i '1s/^\xEF\xBB\xBF//' /app/config/app.json - CI 中可加入检查：
file -i config/*.json | grep -v "utf-8$"
