VS Code C++扩展additionalSOLibSearchPath使用、glob支持及Linux适配问题

1. additionalSOLibSearchPath的跨平台支持 #

additionalSOLibSearchPath并非仅适用于Windows，它是跨平台属性，Linux下同样可以使用。文档中用Windows路径示例只是演示格式，Linux下只需遵循Linux的路径规则（用正斜杠/，多路径分隔符用冒号:）即可。

2. glob模式支持情况 #

该属性不支持glob模式（例如${workspaceFolder}/lib/**这种递归通配符写法），必须指定具体的目录路径，不能用通配符匹配子目录。你之前的配置失效，核心原因是使用了/**的glob语法。

3. Linux下的正确配置方案 #

方案一：修正additionalSOLibSearchPath配置 #

去掉glob通配符，指定具体的共享库目录，多目录用冒号:分隔：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/example/bin/debug/a.out",
            "args": [],
            "environment": [],
            "cwd": "${workspaceFolder}/example/bin",
            "additionalSOLibSearchPath": "${workspaceFolder}/lib",
            "externalConsole": false,
            "MIMode": "gdb"
            // 其他配置项
        }
    ]
}

方案二：通过环境变量LD_LIBRARY_PATH配置 #

这是Linux下管理共享库路径的标准方式，优先级更高，调试和直接运行程序时都能生效：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/example/bin/debug/a.out",
            "args": [],
            "environment": [
                {"name": "LD_LIBRARY_PATH", "value": "${workspaceFolder}/lib:${env:LD_LIBRARY_PATH}"}
            ],
            "cwd": "${workspaceFolder}/example/bin",
            "externalConsole": false,
            "MIMode": "gdb"
            // 其他配置项
        }
    ]
}

方案三：通过gdb命令手动添加搜索路径 #

在setupCommands中直接调用gdb的set solib-search-path命令，灵活性更强：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/example/bin/debug/a.out",
            "args": [],
            "environment": [],
            "cwd": "${workspaceFolder}/example/bin",
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "text": "set solib-search-path ${workspaceFolder}/lib",
                    "description": "Add shared library search path to GDB"
                }
            ]
            // 其他配置项
        }
    ]
}

注意事项 #

• 如果共享库分布在多个子目录，需要逐个列出目录（例如${workspaceFolder}/lib:${workspaceFolder}/lib/subdir），无法通过通配符自动递归。
• 优先推荐方案二，它符合Linux系统的共享库查找逻辑，后续直接运行程序也无需额外配置。

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