解决llvm-mingw项目在Windows下Docker构建失败问题

问题背景

在Windows环境下使用Podman构建llvm-mingw项目的Docker镜像时，会遇到两个主要问题：脚本执行权限问题和CRLF换行符问题。这些问题是跨平台开发中常见的挑战，特别是在混合使用Windows和Linux工具链时。

核心问题分析

1. 脚本执行权限问题

在Windows系统上，当文件被复制到Docker容器中时，默认会丢失可执行权限。这会导致容器内的shell脚本无法正常执行，出现"Permission denied"错误。

解决方案是在Dockerfile中使用--chmod参数显式设置脚本权限：

COPY --chmod=755 build-llvm.sh build-lldb-mi.sh strip-llvm.sh install-wrappers.sh build-mingw-w64.sh build-mingw-w64-tools.sh build-compiler-rt.sh build-libcxx.sh build-mingw-w64-libraries.sh build-openmp.sh ./
COPY --chmod=755 wrappers/*.sh ./wrappers/

2. CRLF换行符问题

Windows使用CRLF(\r\n)作为行结束符，而Linux使用LF(\n)。当Windows上的Git仓库中的shell脚本被复制到Linux容器中时，CRLF会导致脚本无法执行，出现"/bin/sh^M: bad interpreter"错误。

解决方法包括：

1. 配置Git不使用自动换行符转换：

[core]
autocrlf = false

2. 确保所有脚本文件使用LF换行符

构建过程中的其他注意事项

架构参数一致性

在构建过程中，TOOLCHAIN_ARCHS参数必须保持一致。如果在构建wrapper时设置为x86_64，后续构建mingw-w64时也必须使用相同的架构设置，否则会出现工具链不匹配的问题。

环境变量设置

构建过程中需要正确设置环境变量，特别是PATH和TOOLCHAIN_PREFIX，确保工具链能够被正确找到。

完整的解决方案

1. 配置Git不使用自动换行符转换
2. 修改Dockerfile，添加--chmod参数
3. 确保构建过程中架构参数一致
4. 检查所有脚本文件的换行符格式

技术原理深入

Windows与Linux换行符差异

Windows使用CRLF作为行结束符的历史可以追溯到早期的打字机和电传打字机时代，而Unix/Linux选择LF作为行结束符是为了简化设计。这种差异在现代跨平台开发中仍然会造成问题。

Docker文件权限机制

Docker在复制文件时会保留原始文件的权限属性，但在Windows主机上，文件系统不存储Unix风格的权限位，因此需要显式设置。

最佳实践建议

1. 在跨平台项目中统一使用LF换行符
2. 为所有shell脚本添加shebang行(#!/bin/sh)
3. 在CI/CD流程中加入换行符检查
4. 使用预提交钩子(pre-commit hook)确保代码库中的文件使用一致的换行符

通过以上措施，可以确保llvm-mingw项目在Windows环境下通过Docker/Podman顺利构建，避免因平台差异导致的构建失败问题。