GCC动态库制作和调用完整教程
gcc -shared -fPIC 是生成 .so 的唯一正确组合:-fPIC 生成位置无关代码,-shared 指定共享对象格式,二者缺一不可;漏写 -fPIC 会导致链接失败,运行时库找不到需通过 LD_LIBRARY_PATH 或 -Wl,-rpath,'$ORIGIN' 解决。

gcc -shared -fPIC 是生成 .so 的唯一正确组合
要是直接用 gcc -shared 编译而不加 -fPIC ,在Linux系统下十有八九会遇到这样的报错:relocation R_X86_64_32 against `.rodata' can not be used when making a shared object。注意哦,这可不是什么警告,而是在链接阶段就会硬性失败的错误。
-fPIC 生成位置无关代码,这是动态库在内存任意地址加载的前提;-shared 告诉链接器输出共享对象格式。二者缺一不可,顺序无关,但必须同时出现。
- 错误写法:
gcc -shared math_utils.c -o libmath.so(漏-fPIC) - 正确写法(一步到位):
gcc -fPIC -shared math_utils.c -o libmath.so - 正确写法(分步更可控):
gcc -fPIC -c math_utils.c -o math_utils.o,再gcc -shared math_utils.o -o libmath.so
链接时用 -L 和 -l,但运行时找不到库不是链接问题
编译能顺利通过,然而在运行时却报出 ./app: error while loading shared libraries: libmath.so: cannot open shared object file: No such file or directory 这样的错误,这表明链接过程是成功的,但是动态链接器在运行阶段压根就没有找到这个文件。
原因很直接:Linux 动态链接器(ld-linux.so)默认只查 /lib、/usr/lib 和 /usr/local/lib,不会看当前目录(.)。
- 临时解决(开发调试用):
export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH,再运行程序 - 推荐做法(部署用):用
-Wl,-rpath,'$ORIGIN'把运行时搜索路径硬编码进可执行文件,$ORIGIN表示可执行文件所在目录 - 编译命令示例:
gcc main.c -L. -lmath -Wl,-rpath,'$ORIGIN' -o app
头文件里不需要 __declspec(dllexport),但 Windows 上必须加
Linux 的 .so 默认导出所有非 static 全局符号,只要函数不是 static,也不在匿名 namespace 里,就能被外部调用。所以 math_utils.h 里完全不用加任何导出宏。
但如果你写的是跨平台代码(比如同一套源码要编译成 Linux .so 和 Windows .dll),就得条件编译:
- Linux 下:
#define API - Windows 下:
#define API __declspec(dllexport) - 然后所有导出函数声明为
API int add(int, int);
否则 Windows 上 dll 会导出失败,导致 dlsym 或 GetProcAddress 返回 NULL。
libname.so 和 -lname 的命名规则容易对不上
你生成的文件叫 libmath_utils.so,但链接时不能写 -lmath_utils.so 或 -llibmath_utils,必须严格按规则来:
-l后面只写“名字部分”,去掉lib前缀和.so后缀libmath_utils.so→-lmath_utilslibmy.so→-lmylibhello_world.so→-lhello_world
如果名字里有下划线或连字符,就老老实实照抄;别试图省略或改写。GCC 不做模糊匹配,错一个字符就报 cannot find -lxxx。
真正容易被忽略的是:-L 指定的路径必须包含 libxxx.so 文件本身,而不是它的符号链接(比如 libmath.so → libmath.so.1)。某些旧版系统在 -rpath 生效前,会先尝试加载符号链接指向的目标,但如果目标不存在或权限不对,也会静默失败。
Clang环境配置后CMake找不到编译器怎么办
- 上一篇
- Clang环境配置后CMake找不到编译器怎么办
- 下一篇
- GCC环境变量配置后不生效怎么办
-
- 文章 · 软件教程 | 18小时前 | 软件教程 · 代码格式化 JetBrains IDE Actions on Save Reformat Code Changed lines
- JetBrains IDE 保存时怎样只重排改动行
- 442浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | 界面设计 Figma 响应式布局 卡片组件 Auto Layout
- Figma Auto Layout 怎样让卡片随文字自动伸展
- 151浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | 缓存清理 Docker Buildx docker buildx du BuildKit缓存 构建器 缓存占用
- Docker buildx du 怎样按构建器查看缓存占用和可回收空间
- 435浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | Docker Compose docker compose ls Compose项目 容器运维 项目状态
- Docker Compose ls 怎样汇总多个项目的运行状态
- 398浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | 持续集成 · CI/CD Matrix Fail-Fast GitHub Actions continue-on-error 工作流排错
- GitHub Actions 怎样把矩阵失败保留为可诊断结果
- 431浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | VS Code 远程开发 Remote SSH SSH config 主机别名 Remote Explorer
- VS Code Remote SSH 怎样配置多台主机的连接别名
- 152浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | 持续集成 · CI/CD GitHub Actions GITHUB_OUTPUT job outputs needs 下游作业
- GitHub Actions job outputs 怎样把构建信息传给下游作业
- 100浏览 收藏
-
- 文章 · 软件教程 | 18小时前 |
- Git submodule absorbgitdirs 怎样整理子模块的 Git 目录
- 166浏览 收藏
-
- 文章 · 软件教程 | 19小时前 | 开发工具 · VS Code Debug launch.json Compound 多配置调试 同时启动
- VS Code Debug 怎样用 compound 同时启动多个配置
- 294浏览 收藏
-
- 文章 · 软件教程 | 19小时前 | 软件教程 · VS Code Screencast Mode 快捷键提示 Only Keyboard Shortcuts Developer Toggle Screencast Mode
- VS Code 怎样在演示时显示快捷键提示
- 188浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1136次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1121次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1299次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1237次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1089次使用
-
- VS Code Markdown 预览怎样同步定位当前标题
- 2026-11-04 501浏览
-
- VS Code 怎么给 Go 项目配置测试任务:tasks.json 运行与结果验收
- 2026-07-09 501浏览
-
- Windows 11 如何开启 HEIF 图片支持
- 2026-05-31 501浏览
-
- TikTok用户画像与付费订阅变现方法
- 2026-05-27 501浏览
-
- 学信网学历翻译件申请方法
- 2026-05-27 501浏览

