多C源文件中使用头文件定义的Matrix结构体编译报错如何解决？

问题背景 #

我有一个包含main.c、functions.c、functions.h、matrix.c、matrix.h的C语言程序，其中main.c是主文件，functions.c中的函数使用了matrix.h定义的Matrix结构体。编译时出现以下错误：

gcc -c main.c
In file included from main.c:3:
./functions.h:4:22: error: unknown type name 'Matrix'
void populate_matrix(Matrix * matrix);
^
./functions.h:5:19: error: unknown type name 'Matrix'
void print_matrix(Matrix * matrix);
^
2 errors generated.
make: *** [main.o] Error 1

各源文件内容 #

main.c #

#include <stdio.h>
#include "functions.h"

int main()
{
  print_matrix_wrap();
  return 0;
}

functions.c #

#include <stdio.h>
#include <stdlib.h>
#include "functions.h"
#include "matrix.h"


void print_matrix_wrap()
{
  size_t ncol = 4;
  size_t nrow = 4;
  Matrix *mat1 = (Matrix *) calloc(1, sizeof(Matrix));
  
  if (mat1 == NULL) { printf("Could not allocate memory\n"); exit(EXIT_FAILURE); }
  mat1->nrows = nrow;
  mat1->ncols = ncol;
  mat1->array = (int *) calloc(mat1->nrows * mat1->ncols, sizeof(*mat1->array));
  if (mat1->array == NULL) { printf("Could not allocate memory\n"); exit(EXIT_FAILURE); }

  populate_matrix(mat1);
  print_matrix(mat1);
}

void populate_matrix(Matrix * matrix)
{
  matrix->array[0 * matrix->ncols + 0] = 2;
  matrix->array[0 * matrix->ncols + 1] = 3;
  matrix->array[0 * matrix->ncols + 2] = 4;
  matrix->array[0 * matrix->ncols + 3] = 10;
  matrix->array[1 * matrix->ncols + 0] = 3;
  matrix->array[1 * matrix->ncols + 1] = 4;
  matrix->array[1 * matrix->ncols + 2] = 10;
  matrix->array[1 * matrix->ncols + 3] = 8;
  matrix->array[2 * matrix->ncols + 0] = 10;
  matrix->array[2 * matrix->ncols + 1] = 5;
  matrix->array[2 * matrix->ncols + 2] = 6;
  matrix->array[2 * matrix->ncols + 3] = 4;
  matrix->array[3 * matrix->ncols + 0] = 9;
  matrix->array[3 * matrix->ncols + 1] = 10;
  matrix->array[3 * matrix->ncols + 2] = 1;
  matrix->array[3 * matrix->ncols + 3] = 9;
}


void print_matrix(Matrix * matrix)
{
  for (size_t row =0; row<matrix->nrows; row++)
  {
    for (size_t col =0; col<matrix->ncols; col++)
    {
      printf("%3d ", matrix->array[row * matrix->ncols + col]);
    }
    printf("\n");
  }
}

functions.h #

void print_matrix_wrap();
void populate_matrix(Matrix * matrix);
void print_matrix(Matrix * matrix);

matrix.c #

#include <stdio.h>
#include <stdlib.h>
#include "matrix.h"

void print_matrix(Matrix * matrix)
{
  for (size_t row =0; row<matrix->nrows; row++)
  {
    for (size_t col =0; col<matrix->ncols; col++)
    {
      printf("%3d ", matrix->array[row * matrix->ncols + col]);
    }
    printf("\n");
  }
}

matrix.h #

typedef struct {
  size_t nrows, ncols;
  int *array;
} Matrix ;

void print_matrix(Matrix * matrix);

Makefile #

CC = gcc 
CFLAGS = -Wextra -Wall -Wfloat-equal -Wundef -Wshadow -Wpointer-arith -Wcast-align -Wstrict-prototypes -Wstrict-overflow=5 -Wwrite-strings -Waggregate-return -Wcast-qual -Wswitch-default -Wswitch-enum -Wconversion -Wunreachable-code -pedantic -Wmissing-prototypes -Wstrict-prototypes -Wold-style-definition

BINC=main

allc: $(BINC) 

$(BINC): $(BINC).o functions.o matrix.o
    $(CC) $(CFLAGS) $(BINC).o functions.o -o $(BINC)

$(BINC).o: $(BINC).c
    $(CC) -c $(BINC).c

functions.o: functions.c functions.h 
    $(CC) -c functions.c

matrix.o: matrix.c matrix.h 
    $(CC) -c matrix.c

clean:
    $(RM) -rf $(BINC) *.dSYM *.o

runc: allc
    ./$(BINC)

错误原因分析 #

1. 类型未定义：编译main.c时，它包含了functions.h，但functions.h中声明的函数用到了Matrix类型，而main.c和functions.h都没有包含定义Matrix的matrix.h，编译器无法识别该类型。
2. 重复函数定义：functions.c和matrix.c都实现了print_matrix函数，链接阶段会出现重复定义错误。
3. Makefile链接漏洞：当前链接命令漏掉了matrix.o，导致链接时找不到matrix.c中的函数实现。

修改步骤 #

1. 修复functions.h的类型依赖 #

在functions.h开头包含matrix.h，让所有包含该头文件的代码都能获取Matrix类型定义，同时移除重复的函数声明：

#include "matrix.h"

void print_matrix_wrap();
void populate_matrix(Matrix * matrix);

2. 移除重复的print_matrix实现 #

保留matrix.c中的print_matrix函数，删除functions.c里的同名函数实现。

3. 修正Makefile的链接规则 #

修改链接命令，将matrix.o加入链接列表：

$(BINC): $(BINC).o functions.o matrix.o
    $(CC) $(CFLAGS) $(BINC).o functions.o matrix.o -o $(BINC)

4. 给头文件添加包含保护（可选） #

为避免头文件被重复包含引发编译问题，给matrix.h和functions.h添加包含保护：

matrix.h 修改后：

#ifndef MATRIX_H
#define MATRIX_H

typedef struct {
  size_t nrows, ncols;
  int *array;
} Matrix ;

void print_matrix(Matrix * matrix);

#endif // MATRIX_H

functions.h 修改后：

#ifndef FUNCTIONS_H
#define FUNCTIONS_H

#include "matrix.h"

void print_matrix_wrap();
void populate_matrix(Matrix * matrix);

#endif // FUNCTIONS_H

验证修改 #

完成上述修改后，执行make runc，程序将正常编译运行，输出如下矩阵：

2   3   4  10 
  3   4  10   8 
 10   5   6   4 
  9  10   1   9 

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