ubuntu VScode 链接库

### 配置 VSCode 在 Ubuntu 上链接外部库 在 Ubuntu 系统中，使用 VSCode 开发 C++ 程序时，需要手动配置链接库的原因在于 Linux 的库管理机制与 Windows 不同。Linux 下的动态库（`.so` 文件）和静态库（`.a` 文件）通常存放在特定目录中，而编译器不会自动查找这些路径中的库文件[^1]。 为了成功链接外部库，在 VSCode 中可以按照以下方法完成配置： #### 1. 安装所需的库 如果目标库尚未安装，则需先通过包管理工具 `apt-get` 或者源码方式安装。例如，对于 zbar 库，可以通过以下命令获取并解压其压缩包： ```bash sudo wget https://linuxtv.org/downloads/zbar/zbar-0.23.90.tar.gz tar -xzvf zbar-0.23.90.tar.gz cd zbar-0.23.90/ ./configure && make && sudo make install ``` 上述操作会将 zbar 库及其头文件安装到系统的标准路径 `/usr/local/lib/` 和 `/usr/local/include/` 中[^3]。 #### 2. 创建项目结构 假设项目的根目录如下所示： ``` |---example_person.cpp |---CMakeLists.txt |---proto_pb2 |--Person.pb.cc |--Person.pb.h |--CMakeLists.txt |---proto_buf |---General_buf_read.h |---General_buf_write.h |---protobuf |---bin |---... |---include |---... |---lib |---... ``` 此结构表明该项目依赖于多个子模块以及第三方库[^4]。 #### 3. 编写 CMakeLists.txt 为了让构建系统识别外部库，可以在 `CMakeLists.txt` 文件中加入相应的指令来定位库的位置。例如： ```cmake find_package(ZBar REQUIRED) add_executable(example example_person.cpp) target_link_libraries(example PRIVATE ZBar::ZBar) ``` 这里利用了 CMake 提供的 `find_package()` 函数寻找已知名称的库，并将其添加至可执行文件的目标链接列表中。 #### 4. 设置 launch.json 和 tasks.json VSCode 使用 `launch.json` 来定义调试参数，使用 `tasks.json` 来描述预处理任务。以下是两个 JSON 文件的部分片段示例： ##### (1) `.vscode/tasks.json` ```json { "version": "2.0.0", "tasks": [ { "label": "build with cmake", "type": "shell", "command": "/usr/bin/cmake", "args": ["--build", "."], "group": "build" } ] } ``` ##### (2) `.vscode/launch.json` ```json { "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/bin/example", "args": [], "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": true, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "build with cmake", "miDebuggerPath": "/usr/bin/gdb" } ] } ``` 以上设置确保每次启动调试前都会重新构建工程，并且指定了 GDB 调试器的具体路径[^2]。 #### 5. 修改 c_cpp_properties.json 最后一步是在工作区内的 `c_cpp_properties.json` 添加包含路径和库路径的信息，帮助 IntelliSense 正确解析代码中的符号引用。 ```json { "configurations": [ { "name": "Linux", "includePath": [ "${workspaceFolder}/**", "/usr/local/include/" ], "defines": [], "compilerPath": "/usr/bin/gcc", "intelliSenseMode": "gcc-x64", "browse": { "path": [ "${workspaceFolder}" ], "limitSymbolsToIncludedHeaders": true, "databaseFilename": "" }, "macFrameworkPath": [] } ], "version": 4 } ``` 这样就完成了整个流程，使 VSCode 可以正常加载并链接所需外部库。 ---