使用-static-stdlib编译Hummingbird项目时链接错误：找不到指定库

问题原因 #

链接错误提示找不到-lDispatchStubs和-lCoreFoundation，这两个是Swift在Linux环境下运行时的核心静态库，缺失原因是未安装对应系统开发依赖包，或链接器未找到Swift静态库的搜索路径。

解决步骤 #

1. 安装系统依赖包 #

在WSL2的Ubuntu终端执行以下命令，安装包含静态库的开发依赖：

sudo apt update
sudo apt install -y libc6-dev libcurl4-openssl-dev libdispatch-dev libcorefoundation-dev libicu-dev libssl-dev libxml2-dev zlib1g-dev

2. 调整Package.swift配置 #

修改项目的Package.swift，添加链接器搜索路径，确保能找到Swift自带的静态库：

import PackageDescription

let package = Package(
    name: "nomnomnom",
    dependencies: [
        .package(url: "https://github.com/hummingbird-project/hummingbird.git", from: "0.15.2"),
        .package(url: "https://github.com/apple/swift-argument-parser", from: "1.2.3"),
    ],
    targets: [
        .target(
            name: "nomnomnom",
            dependencies: [
                .product(name: "ArgumentParser", package: "swift-argument-parser"),
                .product(name: "Hummingbird", package: "hummingbird"),
                .product(name: "HummingbirdFoundation", package: "hummingbird")
            ],
            swiftSettings: [
                .unsafeFlags(["-Osize", "-whole-module-optimization", "-static-stdlib"])
            ],
            linkerSettings: [
                // Swift默认安装路径下的静态库目录，若Swift安装位置不同需自行调整
                .unsafeFlags(["-L/usr/lib/swift/linux"])
            ]
        )
    ]
)

3. 验证Swift安装路径 #

若你的Swift未安装在默认的/usr/lib/swift，可通过以下命令确认安装路径：

which swift
# 若输出为/usr/bin/swift，则静态库路径通常为/usr/lib/swift/linux

4. 重新构建项目 #

执行发布版本构建命令：

swift build --configuration release

额外说明 #

• -static-stdlib仅会静态链接Swift标准库，系统级依赖（如libc、libssl）仍为动态链接，若需全静态链接需添加额外链接器标志，但可能引发兼容性问题。
• 若仍提示找不到库，检查Swift安装目录下的lib/swift/linux文件夹，确认存在libDispatchStubs.a和libCoreFoundation.a文件，若缺失需重新安装完整的Swift SDK。

内容的提问来源于stack exchange，提问作者Zapnuk