嵌入式通用C代码PC测试：gcc头文件链接及依赖处理

背景 #

开发嵌入式项目时，部分硬件无关的通用C代码可在x86 PC上运行，计划通过PC端测试配合valgrind做检测，但遇到链接环节问题。

项目固定结构：

lib
  util.c
  ...
include
  lib
    util.h
    logging.h
    ...
  ...
...
test
  testrunner.py
  tests
    test1.c
    ...

util.c中包含：

#include "lib/util.h"
#include "lib/logging.h"

需在testX.c中调用util模块，且不使用CMake。

问题1：仅链接util相关的源文件与头文件 #

解决方法 #

通过gcc参数明确指定需要的头文件路径和源文件，避免引入无关代码：

• 头文件路径：用-I../include指定项目根目录的include文件夹，确保编译器能找到lib/util.h
• 源文件：直接列出测试文件tests/testX.c和util的源文件../lib/util.c

示例编译命令：

gcc -I../include tests/testX.c ../lib/util.c -o testX

此命令只会编译并链接util相关的代码，不会涉及其他无关文件。

问题2：处理util依赖的logging模块 #

最优方案 #

由于logging当前仅实现断言功能，直接在test目录下编写PC适配版的logging是最简单的方式：

1. 在test目录下创建include/lib结构，放入PC版本的logging.h和对应的实现文件logging.c
2. 编译时将-Iinclude放在-I../include之前，让编译器优先使用test目录下的PC版头文件，覆盖嵌入式版本

示例编译命令：

gcc -Iinclude -I../include tests/testX.c ../lib/util.c include/lib/logging.c -o testX

最终目录结构与验证 #

调整后test目录结构如下：

test
  Makefile
  include/lib/logging.h
  include/lib/logging.c
  testrunner.py
  tests
    test1.c
    ...

编译时，编译器会优先加载test/include/lib/logging.h，同时util.c仍能正常找到../include/lib/util.h，既满足PC端测试需求，又不改动原有项目结构。

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