llvm-mingw

### 关于 llvm-mingw 的使用指南

#### 安装过程
对于希望在 Windows 平台上利用 LLVM 工具链的开发者来说，`llvm-mingw` 提供了一个基于 LLVM 和 Clang 构建的 MinGW-w64 替代方案。为了安装 `llvm-mingw`，通常可以从其官方网站下载预编译版本并解压至指定位置[^1]。

tar xf llvm-mingw-*.tar.xz -C /opt/
export PATH="/opt/llvm-mingw/bin:$PATH"

这段脚本展示了如何将压缩包解压到 `/opt/` 文件夹下，并更新环境变量使得命令行能够识别新的可执行文件路径。

#### 配置说明
配置阶段主要涉及确保正确的库路径被设置好，特别是针对 C++ 应用程序而言。如果遇到动态链接错误提示找不到特定版本的标准库，则可能是因为 `-rpath` 设置不当所致[^5]。此时应当确认构建过程中是否正确指定了目标平台上的标准库位置：

./configure --prefix=/usr/local \
            --with-gcc-toolchain=/usr \
            LDFLAGS="-Wl,-rpath,/usr/lib/x86_64-linux-gnu/"

上述例子假设 Linux 系统上 GCC 已经安装完毕，并且想要让新安装的 LLVM 工具链优先使用系统的 libstdc++ 而不是自带的一个较旧版本。

#### 使用方法概述
一旦成功完成了安装与初步配置之后，就可以像平常一样调用 `clang`, `lld-link` 或者其他的 LLVM 组件来开发跨平台的应用程序了。值得注意的是，在某些情况下还需要额外传递参数给编译器以适应不同操作系统之间的差异:

// example.cpp
#include <iostream>
int main() {
    std::cout << "Hello, world!" << std::endl;
}

编译此简单的 Hello World 程序可以通过如下方式完成：

clang++ -target x86_64-pc-windows-msvc example.cpp -o hello.exe

这里选择了 MSVC ABI 兼容模式 (`-target x86_64-pc-windows-msvc`) 来生成适用于 Windows 的二进制文件。

#### 解决常见问题
当面对诸如无法启动应用程序或是缺少依赖项等问题时，建议先查阅官方文档中的 [FAQ 页面][^2] 寻找解决方案；另外也可以考虑加入社区论坛获取更多帮助和支持。例如，关于 rpath 失败的情况已经提到过处理办法——调整相应的链接选项即可解决问题。