1. 项目概述
在软件开发过程中,代码统计是一个看似简单但极其重要的环节。作为使用Qt框架开发十余年的老手,我经常需要快速评估项目规模、监控代码变化趋势。市面上虽然有不少代码统计工具,但要么功能过于复杂,要么无法满足Qt项目的特殊需求(比如要区分QML和C++代码)。这就是为什么我决定用Qt自己开发一个轻量级但功能完备的代码统计工具。
这个工具的核心价值在于:
- 精确统计Qt项目中的各类文件(.cpp/.h/.qml/.ui等)
- 支持递归扫描整个项目目录
- 实时显示统计结果并生成简洁报告
- 完全开源且跨平台运行
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 开发环境准备
2.1 Qt版本选择
经过多个版本测试,我最终选择Qt 5.15.2 LTS版本作为开发基础,原因有三:
- 长期支持版本稳定性有保障
- 对C++17特性的完整支持
- 在Windows/Linux/macOS三大平台表现一致
注意:如果使用Qt6开发,需要注意QDirIterator等文件遍历API的变动,新版本性能更好但语法略有不同。
2.2 必要组件
在Qt Creator中新建项目时,需要勾选以下模块:
qmake复制QT += core gui widgets
CONFIG += c++17
对于更复杂的统计需求(如代码复杂度分析),可以额外添加:
qmake复制QT += concurrent # 用于多线程处理大型项目
3. 核心功能实现
3.1 文件遍历模块
使用QDirIterator递归扫描目录是最可靠的方式:
cpp复制void CodeCounter::scanDirectory(const QString &path) {
QDirIterator it(path,
QDir::Files | QDir::NoDotAndDotDot,
QDirIterator::Subdirectories);
while (it.hasNext()) {
QString filePath = it.next();
if (isSourceFile(filePath)) { // 自定义过滤函数
processFile(filePath);
}
}
}
文件类型判断逻辑:
cpp复制bool isSourceFile(const QString &filename) {
static QStringList extensions = {
"cpp", "h", "hpp", "c", "qml", "ui", "pro", "qrc"
};
return extensions.contains(QFileInfo(filename).suffix());
}
3.2 代码统计算法
3.2.1 基础统计
对于每种文件类型,我们需要统计:
- 文件数量
- 总行数
- 空行数
- 注释行数
- 有效代码行数
核心计数函数示例:
cpp复制FileStats countLines(const QString &filePath) {
QFile file(filePath);
if (!file.open(QIODevice::ReadOnly))
return FileStats();
FileStats stats;
bool inBlockComment = false;
QTe
