Mac M1 VS Code中Boost filesystem符号未找到问题求助

使用Boost Filesystem处理文件时遇到动态链接错误：

dyld[70964]: Symbol not found: __ZN5boost10filesystem6detail6statusERKNS0_4pathEPNS_6system10error_codeE
  Referenced from: <D67FA2B8-D2CA-381C-98F1-3E8E006E3984> /Users/dmonti/Documents/Code/TestProj2/main
  Expected in:     <no uuid> unknown

环境：Mac M1 Ventura 13.5.1 + VS Code (C++)
Boost编译步骤：

./bootstrap.sh
./b2

tasks.json配置：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: clang++ build active file",
            "command": "/usr/bin/clang++",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-I/Users/dmonti/Documents/Code/lib/boost_1_82_0",
                "-L/Users/dmonti/Documents/Code/lib/boost_1_82_0/stage/lib",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-lboost_system",
                "-lboost_filesystem"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "Task generated by Debugger."
        }
    ],
    "version": "2.0.0"
}

main.cpp代码：

#include <iostream>
#include <boost/filesystem.hpp>

int main(int argc, char *argv[]) {
    namespace fs = boost::filesystem;

    fs::path p = fs::path("text.txt");
    if(fs::is_regular_file(p)) 
        std::cout<<"File"<<std::endl;
    else if(fs::is_directory(p))
        std::cout<<"Dir"<<std::endl;
    else 
        std::cout<<"Something else."<<std::endl;
    return 0; 
}

1. 确保Boost库适配M1架构 #

M1为arm64架构，先检查现有库的架构兼容性：

lipo -info /Users/dmonti/Documents/Code/lib/boost_1_82_0/stage/lib/libboost_filesystem.dylib

若输出不含arm64，则重新编译Boost：

# 清理旧编译产物
./b2 clean
# 指定arm64架构编译
./bootstrap.sh
./b2 architecture=arm address-model=64 link=shared,static

2. 添加运行时库路径（rpath） #

编译时需告知程序运行时查找动态库的路径，修改tasks.json的args：

"args": [
    "-fcolor-diagnostics",
    "-fansi-escape-codes",
    "-I/Users/dmonti/Documents/Code/lib/boost_1_82_0",
    "-L/Users/dmonti/Documents/Code/lib/boost_1_82_0/stage/lib",
    "-Wl,-rpath,/Users/dmonti/Documents/Code/lib/boost_1_82_0/stage/lib",
    "-g",
    "${file}",
    "-o",
    "${fileDirname}/${fileBasenameNoExtension}",
    "-lboost_filesystem",
    "-lboost_system"
]

注意：调整链接顺序，-lboost_filesystem需放在-lboost_system之前（链接器从左到右处理依赖，Filesystem依赖System库）。

3. 统一Boost版本 #

你参考的是Boost 1.84文档，但使用的是1.82版本库，建议保持版本一致：要么重新编译1.84版本，要么切换到1.82官方文档。

4. 尝试静态链接（可选） #

若动态链接问题仍未解决，可改用静态链接：

• 编译Boost时指定静态链接：./b2 link=static
• 在tasks.json的args中添加-static参数，确保链接静态库。

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