多头文件中全局变量的使用问题及解决方案

项目背景 #

我正在开发一个电话簿程序，支持从CSV读取数据或通过scanf终端输入，将信息存入struct链表。项目要求使用struct类型的全局头指针，涉及三个文件：

• main.c：负责菜单逻辑与函数调用
• phone.c：实现增删查改等核心功能
• helper.c：存放辅助函数

需要通过头文件与Makefile完成编译，遇到两个核心问题：

1. 如何通过头文件让全局head指针在多文件中正常访问
2. 如何正确使用.o目标文件完成编译

注：我清楚全局变量并非最佳实践，但这是项目硬性要求。

失败的尝试方案 #

方案1 #

• 在helper.h中声明struct，helper.c中定义struct和全局head指针
• phone.c包含helper.h可正常访问，但main.c同时包含phone.h和helper.h时，触发multiple definitions编译错误

方案2 #

• 在phone.h中声明struct，phone.c中定义
• 因依赖关系需要互相包含头文件，导致多定义与作用域错误

此外还遇到过编译成功但运行时段错误的情况：main.c能访问*HEAD，但phone.c无法访问该指针。

最终可行的配置步骤 #

1. 在phone.h中声明struct PHONE_RECORD结构体
2. 在phone.h中添加全局指针的外部声明：extern struct PHONE_RECORD *HEAD;
3. 在phone.c中定义全局指针并初始化：struct PHONE_RECORD *HEAD = NULL;
4. phone.c中包含phone.h与helper.h
5. helper.c中仅包含phone.h
6. helper.h只保留辅助函数的声明，不包含结构体或全局变量定义
7. main.c中包含phone.h与helper.h

正确的编译方式 #

先单独编译每个源文件生成目标文件：

gcc -c main.c
gcc -c phone.c
gcc -c helper.c

再将所有目标文件链接生成可执行程序：

gcc main.o phone.o helper.o -o phone_book

目前所有文件均可正常访问*HEAD，无编译错误与运行段错误。

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