C控制台程序编译无报错但未运行，求问题排查方案

两天前在Stack Overflow咨询了C控制台程序多.c/.h文件组织的问题，按社区建议搭建了项目结构，执行编译命令后没有任何输出，程序也无法运行，具体信息如下：

项目文件内容 #

main.c #

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <stdbool.h>
#include "utils.h"
#include "structs.h"
#include "search.h"

int main () {
    ...
    clear();
    ...
    search();
    ...
    return 0;
}

utils.c #

#include "utils.h"

void clear() {
    #ifdef _WIN32
    system("cls");
    #else
    system("clear");
    #endif
}

utils.h #

#ifndef UTILS_H
#define UTILS_H

#include <stdlib.h>

void clear();

#endif

structs.h #

#ifndef STRUCTS_H
#define STRUCTS_H

typedef struct {
    char *brand;
    float fee;
} Brand;

typedef struct {
    Brand brand;
    char *model;
    char *color;
    float price;
} Car;

#endif

search.c #

#include <search.h>

Car *search () {
    ...
    clear();
    ...
    Car cars[255];
    ...
    return cars;
}

search.h #

#ifndef SEARCH_H
#define SEARCH_H

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <stdbool.h>
#include "utils.h"
#include "structs.h"

Car *search ();

#endif

编译命令 #

gcc -o output main.c utils.c search.c

问题排查方向 #

• 确认编译是否成功：检查当前目录是否生成了output（Linux/macOS）或output.exe（Windows）可执行文件。如果未生成，添加-Wall参数查看详细警告：gcc -Wall -o output main.c utils.c search.c，隐性错误通常会通过警告暴露。
• 修正search.c的头文件引用：#include <search.h>是引用系统头文件，你的自定义头文件应为#include "search.h"，否则无法识别Car类型和clear()函数，会导致编译或运行异常。
• 修复返回局部数组的严重问题：search()函数返回栈上定义的Car cars[255]，栈内存在函数返回后会被释放，触发未定义行为，可能导致程序崩溃、无输出。需改用动态内存分配：

Car *search () {
    ...
    Car *cars = malloc(255 * sizeof(Car));
    if (cars == NULL) {
        // 处理内存分配失败逻辑
        return NULL;
    }
    ...
    return cars;
}

调用search()后记得用free()释放内存，避免泄漏。

• 确认是否执行了可执行文件：编译成功后需手动运行程序——Linux/macOS执行./output，Windows执行output.exe，仅执行编译命令不会自动运行程序。

内容的提问来源于stack exchange，提问作者Matheus Caetano Rocha