C程序嵌入Python引入Python.h编译出现未定义引用错误如何解决
你遇到的是典型的链接阶段符号缺失错误,编译时已经成功找到Python.h头文件,但链接时没有关联Python官方的运行库,因此无法找到Python相关API的实现。
修复步骤
1. 确认Python库文件
先检查项目根目录下lib文件夹中的Python库文件名,Windows下搭配gcc使用的库文件通常命名为libpython<版本号>.a,例如Python3.11对应的文件为libpython3.11.a或libpython311.a,记录下对应的版本号。
2. 修改Makefile配置
需要修改的点如下:
- 编译参数添加
-DPy_ENABLE_SHARED宏,适配Windows下Python动态库的符号导入规则 - 链接参数添加
-L$(LDIR),让编译器可以找到lib目录下的库文件 - 链接依赖添加Python库的链接参数,例如
-lpython311 - 修正原Makefile中目标文件路径引用错误的问题
修改后的完整Makefile示例(注意替换-lpython311为你实际的Python版本):
IDIR =../include CC=gcc # 新增Python动态库导入所需的宏定义 CFLAGS=-I$(IDIR) -DPy_ENABLE_SHARED ODIR=obj LDIR =../lib # 此处替换为你实际的Python库版本,如Python3.10则改为-lpython310 LIBS=-lm -lpython311 _DEPS = hellomake.h DEPS = $(patsubst %,$(IDIR)/%,$(_DEPS)) _OBJ = hellomake.o hellofunc.o OBJ = $(patsubst %,$(ODIR)/%,$(_OBJ)) # 自动创建obj目录避免编译报错 $(shell mkdir -p $(ODIR)) $(ODIR)/%.o: %.c $(DEPS) $(CC) -c -o $@ $< $(CFLAGS) # 修正目标文件依赖,添加库目录搜索参数 hellomake: $(OBJ) $(CC) -o $@ $^ $(CFLAGS) -L$(LDIR) $(LIBS) .PHONY: clean clean: rm -rf $(ODIR) *.o *~ core $(INCDIR)/*~
注意:Makefile中每个规则的命令行必须以Tab缩进,不能用空格,否则会触发make报错。
3. 运行时注意事项
Windows下运行生成的hellomake.exe前,需要将Python对应的python3xx.dll文件放到exe同目录,或者将Python安装目录的路径添加到系统PATH环境变量,否则会出现运行时找不到dll的错误。
额外排查点
如果修改后仍然报错,检查你的gcc位数(可通过gcc -v查看)和Python库的位数是否一致,32位gcc只能链接32位编译的Python库,64位同理。
内容的提问来源于stack exchange,提问作者Turtleofjohari
相关产品推荐
相关产品推荐

