C++项目引入<QtWidgets>头文件报错：文件或目录不存在

问题分析 #

从编译日志能看到，g++编译命令里完全没包含Qt的头文件路径——你在Makefile里定义了CXXFLAGS += -I/usr/include/qt5，但编译规则根本没用到这个变量，导致Qt的头文件路径没被加入编译参数。另外，仅指定/usr/include/qt5也不够，QtWidgets的头文件实际在/usr/include/qt5/QtWidgets，手动指定路径容易遗漏依赖，更可靠的方式是用pkg-config自动获取Qt的编译和链接参数。

解决方案 #

1. 确认依赖包完整安装 #

先确保Qt Widgets相关开发包都装了：

sudo apt install qtbase5-dev qt5-qmake libqt5widgets5-dev

2. 修改Makefile，用pkg-config自动处理Qt依赖 #

替换原Makefile的相关部分，修正编译和链接逻辑：

# Makefile for Comet code editor

# Compiler
CC := g++
# Compiler flags
CFLAGS := -std=c++11 -Wall -Wextra
# 通过pkg-config获取Qt5 Widgets的编译/链接参数
QT_CFLAGS := $(shell pkg-config --cflags Qt5Widgets)
QT_LIBS := $(shell pkg-config --libs Qt5Widgets)
# 项目自身的include路径
INCLUDE := -Isrc -Isrc/lib

# Directories
SRCDIR := src
BUILDDIR := bin
BINDIR := bin

# 注意：仅保留需要编译的.cpp文件，.hpp和.css不需要加入SOURCES
SOURCES = src/main.cpp src/ui/mainwindow.cpp
# Object files
OBJECTS := $(patsubst $(SRCDIR)/%.cpp,$(BUILDDIR)/%.o,$(SOURCES))
# Target executable
TARGET := $(BINDIR)/comet

# Default target
all: $(TARGET)

# 链接阶段：加入Qt库依赖
$(TARGET): $(OBJECTS)
    @mkdir -p $(BINDIR)
    $(CC) $(OBJECTS) $(QT_LIBS) -o $(TARGET)

# 编译阶段：加入Qt头文件路径，自动创建子目录
$(BUILDDIR)/%.o: $(SRCDIR)/%.cpp
    @mkdir -p $(dir $@)
    $(CC) $(CFLAGS) $(INCLUDE) $(QT_CFLAGS) -c $< -o $@

# Run the comet executable
run: $(TARGET)
    ./$(TARGET)

# Cleaning
clean:
    rm -r $(BUILDDIR)

# Phony targets
.PHONY: all run clean

关键修改点说明 #

• 清理SOURCES列表：.hpp头文件和.css资源文件不需要被编译成目标文件，只保留.cpp源文件
• 用pkg-config自动获取参数：避免手动写路径出错，pkg-config会自动输出QtWidgets所需的所有头文件路径和链接库
• 编译规则加入QT_CFLAGS：确保编译时能找到Qt的头文件
• 链接规则加入QT_LIBS：解决后续运行时找不到Qt动态库的问题
• 自动创建子目录：用$(dir $@)自动生成bin/ui这类子目录，避免编译时因目录不存在报错

3. 重新编译测试 #

执行以下命令清理旧文件并重新编译：

make clean
make
./bin/comet

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