QT5.14.2安装后，你的第一个C项目从创建到运行（附目录规划建议）-编程阁

QT5.14.2第一个C项目实战：从零构建到目录规划

刚安装完QT的新手开发者常会遇到一个尴尬局面——面对功能丰富的QT Creator界面却不知从何下手。本文将手把手带你完成第一个C语言项目的创建、配置到运行全过程，并分享经过实战检验的目录规划方案，让你避开初学者的常见陷阱。

1. 项目创建：从空白到代码框架

打开QT Creator后，别被复杂的界面吓到。我们先从最基础的Plain C Application开始，这是学习QT开发的最佳起点。

1.1 新建项目关键步骤

点击左上角"File"→"New File or Project"，在弹出的向导中：

选择"Non-Qt Project"分类下的"Plain C Application"
命名项目时建议使用全小写字母+下划线组合（如my_first_app）
项目路径必须遵循两个原则：
- 绝对避免中文路径（如D:/我的项目会导致各种诡异问题）
- 不要放在系统盘根目录（推荐类似D:/dev/projects/c_basics的结构）

注意：创建路径时建议勾选"设为默认的项目路径"，这样下次新建项目会自动定位到该目录。

1.2 构建系统配置要点

在构建系统选择界面，新手开发者常对qmake、CMake等选项感到困惑。对于第一个C项目：

优先选择qmake：作为QT原生的构建工具，配置简单适合入门
保持默认Kit配置：通常会自动检测已安装的MinGW编译器
取消版本控制集成：初学时可以暂时不勾选Git等选项

完成创建后，你会看到自动生成的main.c文件，这是典型的C程序入口文件：

#include <stdio.h> int main(int argc, char *argv[]) { printf("Hello World!\n"); return 0; }

2. 目录结构规划实战方案

混乱的目录结构是后期项目维护的噩梦。下面这个经过多个实际项目验证的方案，既保持简单又具备扩展性：

my_project/ ├── build/ # 编译输出目录（建议添加到.gitignore） ├── docs/ # 项目文档 ├── include/ # 头文件 ├── src/ # 源代码 │ ├── core/ # 核心业务逻辑 │ └── utils/ # 工具函数 └── tests/ # 单元测试

2.1 关键目录规范

build目录分离：保持源码目录干净，所有构建产物集中存放
头文件隔离：include与src分离是C项目的经典做法
测试驱动开发：即使简单项目也建议预留tests目录

实际案例：一个温度转换项目的目录示例

temp_converter/ ├── include/ │ └── converter.h ├── src/ │ ├── converter.c │ └── main.c └── tests/ └── test_converter.c

3. 项目配置深度优化

默认生成的qmake配置可能需要一些调整才能获得最佳开发体验。

3.1 修改.pro文件

在项目根目录的.pro文件中添加这些配置：

# 指定C标准版本 CONFIG += c11 # 启用所有警告 QMAKE_CFLAGS += -Wall -Wextra # 调试信息配置 CONFIG(debug, debug|release) { QMAKE_CFLAGS += -g } else { QMAKE_CFLAGS += -O2 }