Windows10下如何在Visual Studio Code中创建运行C++多文件项目

1. 前期环境检查 #

• 确保VS Code已安装官方C/C++扩展
• 确保MinGW工具链已安装，且g++、make对应的bin目录已加入Windows系统环境变量，可在终端输入g++ --version、make --version验证是否配置成功
• 新建空文件夹作为项目根目录，直接用VS Code打开该文件夹作为工作目录

2. 项目文件结构创建 #

在根目录下新建4类文件：

• 自定义头文件（后缀为.h）：用于存放函数声明、宏定义、结构体/类声明
• 功能实现文件（后缀为.cpp）：用于存放头文件中声明内容的具体实现
• 主程序文件（后缀为.cpp）：存放main函数作为程序入口
• 你已掌握编写方法的Makefile，直接放在根目录即可

3. 代码示例（符合头文件编写规范） #

示例头文件math_utils.h #

需添加头文件守卫避免重复引用：

#ifndef MATH_UTILS_H
#define MATH_UTILS_H

// 函数声明
int add(int a, int b);

#endif

示例实现文件math_utils.cpp #

// 引入对应头文件
#include "math_utils.h"

int add(int a, int b) {
    return a + b;
}

示例主程序文件main.cpp #

#include <iostream>
// 引入自定义头文件用双引号，不要用尖括号
#include "math_utils.h"

int main() {
    std::cout << add(2, 3) << std::endl;
    return 0;
}

适配当前项目的Makefile参考 #

# 指定编译器
CXX = g++
# 编译参数：开启警告、生成调试信息
CXXFLAGS = -Wall -g
# 最终生成的可执行文件名
TARGET = main
# 所有参与编译的cpp源文件
SRCS = main.cpp math_utils.cpp
# 对应的目标文件
OBJS = $(SRCS:.cpp=.o)

# 链接生成可执行文件
$(TARGET): $(OBJS)
	$(CXX) $(CXXFLAGS) -o $(TARGET) $(OBJS)

# 清理生成的中间文件和可执行文件
clean:
	rm -f $(OBJS) $(TARGET)

4. VS Code中编译运行操作 #

• 按快捷键`Ctrl+`` 调出VS Code内置终端
• 输入make命令执行编译，编译成功后根目录会生成main.exe可执行文件
• 终端输入.\main.exe即可运行程序
• 修改代码后重新执行make即可自动增量编译修改过的文件
• 需要清理生成文件时执行make clean

常见问题排查 #

• 提示make不是内部命令：部分MinGW版本的make程序名为mingw32-make.exe，可直接用mingw32-make代替make命令，或把程序重命名为make.exe
• 提示头文件找不到：检查自定义头文件的引入语法是否为双引号""，确认头文件确实放在项目根目录
• 提示链接错误：检查实现文件的函数签名和头文件声明是否完全一致，确认Makefile的SRCS列表已包含所有用到的cpp文件

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