关于vs一个项目提示main被多次引用的解决方法

错误信息如图

首先，在 Visual Studio 中遇到“多个 main 函数被引用”的报错，通常是因为同一个项目中存在多个包含 main 函数（程序入口点）的源文件。

原因

这是由于C/C++ 程序的入口规则，每个可执行程序（如 .exe）必须且只能有一个入口点（即 main 函数）。如果项目中多个文件定义了 main 函数，编译器在链接阶段会因冲突而报错。

第二个就是项目结构问题，Visual Studio 默认将同一项目下的所有源文件编译并链接到同一个可执行文件中。如果项目中存在多个 main 函数，会直接导致冲突。

举例子

比如项目中存在多个用于测试的 .cpp或.c 文件，每个文件都写了 main 函数。

或者你在引用第三方库时，恰好第三方库也包含main函数。

解决方法

排除某些（你暂且不用到的）文件编译

可以排除某些文件的编译。具体步骤如下：
1.    右键点击解决方案资源管理器中的文件（例如 Hello.c 或 Hello.cpp）。
2.    选择 属性。
3.    在属性页中，选择 配置属性 > 常规。
4.    将 排除生成 设置为 是。

已经排除的文件文件图标会出现一个类似减号—的红色符号

重命名

比如int main()  ==>  int main_test()  //此时main_test只是一个普通函数，不再具有函数入口功能。

int main_test() {
    // 原 main 内容
    return 0;
}

分离项目

仅使用每个main对应一个独立的程序。
将包含不同 main 函数的文件分离到不同的项目中，每个项目各自编译和运行。
通过这些方法，可以避免多个 main 函数的冲突，确保项目能够正确编译和链接。

条件编译

1、#if 0和#if 1

适用于简单的调试，通过更改0或1即可

// File1.cpp
#if 0  // 禁用此 main
int main() {
    // 测试代码1
    return 0;
}
#endif

// File2.cpp
#if 1  // 启用此 main
int main() {
    // 正式代码
    return 0;
}
#endif

2、通过宏定义

在 Visual Studio 中定义宏

右键项目 → 属性 → C/C++ → 预处理器 → 预处理器定义 → 添加 USE_MAIN_A 或 USE_MAIN_B。（有第三个文件就添加如USE_MAIN_C即可，有更多文件也类似）

注意每次编译前，通过修改宏定义切换入口，编译时必须保证最终只有一个 main 函数被启用，否则仍会报错。比如：如果同时定义 USE_MAIN_A 和 USE_MAIN_B，两个 main 都会被编译，导致链接错误。

// FileA.cpp
#ifdef USE_MAIN_A
int main() {
    // 功能A的入口
    return 0;
}
#endif

// FileB.cpp
#ifdef USE_MAIN_B
int main() {
    // 功能B的入口
    return 0;
}
#endif

扩展

同时我们可以利用#if defined() 实现更复杂的条件判断。

在 C/C++ 中，#if defined() 是条件编译的核心指令之一，可以通过逻辑运算符（如 &&、||、!）和数值比较实现复杂的条件判断。

1. 检查单个宏是否定义

#if defined(MACRO_NAME)
    // 如果定义了 MACRO_NAME，编译此代码
#endif

或简写为：

#ifdef MACRO_NAME
    // 等价于 #if defined(MACRO_NAME)
#endif

2. 检查宏是否未定义

#if !defined(MACRO_NAME)
    // 如果未定义 MACRO_NAME，编译此代码
#endif

或简写为：

#ifndef MACRO_NAME
    // 等价于 #if !defined(MACRO_NAME)
#endif

---

1. 逻辑与（&&）

要求同时满足多个条件：

#if defined(MACRO_A) && defined(MACRO_B)
    // MACRO_A 和 MACRO_B 均已定义时编译
#endif

2. 逻辑或（||）

满足任一条件即可：

#if defined(MACRO_A) || defined(MACRO_B)
    // MACRO_A 或 MACRO_B 至少一个定义时编译
#endif

3. 逻辑非（!）

取反条件：

#if defined(MACRO_A) && !defined(MACRO_B)
    // MACRO_A 已定义，但 MACRO_B 未定义时编译
#endif

4. 组合嵌套

通过括号明确优先级：

#if (defined(MACRO_A) || defined(MACRO_B)) && !defined(MACRO_C)
    // MACRO_A 或 MACRO_B 已定义，且 MACRO_C 未定义时编译
#endif