🌸 欢迎来到Python办公自动化专栏—Python处理办公问题，解放您的双
💻 个人主页——>个人主页欢迎访问
😸 Github主页——>Github主页欢迎访问
❓ 知乎主页——>知乎主页欢迎访问
🏳️🌈 CSDN博客主页：请点击——> 一晌小贪欢的博客主页求关注
👍 该系列文章专栏：请点击——>Python办公自动化专栏求订阅
🕷 此外还有爬虫专栏：请点击——>Python爬虫基础专栏求订阅
📕 此外还有python基础专栏：请点击——>Python基础学习专栏求订阅
文章作者技术和水平有限，如果文中出现错误，希望大家能指正🙏
❤️ 欢迎各位佬关注！ ❤️
前言
作为一名开发者，你是否经常需要统计项目中的代码行数？是否厌倦了使用命令行工具或者在线工具的繁琐操作？今天，我将分享如何使用PyQt5开发一款功能强大、界面美观的Python代码行数统计工具。
项目背景
在日常开发中，我们经常需要：
- 📊 统计项目的代码规模
- 📈 分析代码质量（代码行vs注释行比例）
- 📋 生成项目报告
- 🔍 快速了解项目结构
传统的解决方案往往存在以下问题：
- 命令行工具操作复杂
- 在线工具需要上传代码（安全隐患）
- 功能单一，缺乏可视化
- 不支持批量处理
因此，我决定开发一款集成度高、操作简便的图形化工具。
技术选型
为什么选择PyQt5？
- 跨平台支持 - 一次开发，多平台运行
- 丰富的组件 - 提供完整的GUI组件库
- 成熟稳定 - 经过多年发展，稳定性极佳
- Python生态 - 与Python完美集成
- 现代化界面 - 支持样式表，可以打造美观界面
核心技术栈
- GUI框架: PyQt5
- 多线程: QThread（避免界面卡顿）
- 文件处理: Python标准库
- 正则表达式: 智能识别注释和代码
功能设计
核心功能
-
拖拽支持 🖱️
- 支持拖拽单个或多个.py文件
- 支持拖拽目录（自动递归扫描）
- 直观的拖拽区域设计
-
智能统计 🧠
- 准确识别代码行、注释行、空行
- 支持单行注释（#）
- 支持多行注释（"""或'''）
- 正确处理行末注释
-
批量处理 ⚡
- 多线程处理，避免界面卡顿
- 实时进度显示
- 支持大型项目扫描
-
结果展示 📊
- 树形结构显示文件和目录
- 详细的统计信息
- 目录汇总功能
-
导出功能 💾
- 支持导出统计结果
- 文本格式，便于分享
核心代码实现
1. 代码行数统计算法
@staticmethod
def count_lines(file_path: str) -> Dict[str, int]:
"""智能统计代码行数"""
try:
with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
lines = f.readlines()
except Exception:
return {'total': 0, 'code': 0, 'comment': 0, 'blank': 0}
total_lines = len(lines)
code_lines = 0
comment_lines = 0
blank_lines = 0
in_multiline_string = False
multiline_quote = None
for line in lines:
stripped = line.strip()
# 空行处理
if not stripped:
blank_lines += 1
continue
# 多行字符串处理
if in_multiline_string:
if multiline_quote in stripped:
quote_count = stripped.count(multiline_quote)
if quote_count % 2 == 1:
in_multiline_string = False
multiline_quote = None
comment_lines += 1
continue
# 检查多行字符串开始
if '"""' in stripped or "'''" in stripped:
# ... 处理逻辑
# 单行注释
if stripped.startswith('#'):
comment_lines += 1
continue
# 代码行
code_lines += 1
return {
'total': total_lines,
'code': code_lines,
'comment': comment_lines,
'blank': blank_lines
}
2. 拖拽功能实现
class DropArea(QLabel):
"""支持拖拽的区域"""
files_dropped = pyqtSignal(list)
def __init__(self):
super().__init__()
self.setAcceptDrops(True)
self.setAlignment(Qt.AlignCenter)
# 设置样式和提示文本
def dragEnterEvent(self, event: QDragEnterEvent):
if event.mimeData().hasUrls():
event.acceptProposedAction()
# 更新视觉反馈
def dropEvent(self, event: QDropEvent):
files = []
for url in event.mimeData().urls():
file_path = url.toLocalFile()
if os.path.exists(file_path):
files.append(file_path)
if files:
self.files_dropped.emit(files)
3. 多线程处理
class CounterThread(QThread):
"""后台统计线程"""
progress_updated = pyqtSignal(int, int)
file_processed = pyqtSignal(str, dict)
directory_processed = pyqtSignal(str, dict)
finished = pyqtSignal()
def run(self):
# 收集所有文件
all_files = []
for path in self.paths:
if os.path.isfile(path) and path.endswith('.py'):
all_files.append(path)
elif os.path.isdir(path):
py_files = self.counter.scan_directory(path)
all_files.extend(py_files)
# 逐个处理文件
for i, file_path in enumerate(all_files):
stats = self.counter.count_lines(file_path)
self.file_processed.emit(file_path, stats)
self.progress_updated.emit(i + 1, len(all_files))
界面设计亮点
1. 现代化样式
使用CSS样式表打造现代化界面：
self.setStyleSheet("""
QMainWindow {
background-color: #f5f5f5;
}
QPushButton {
background-color: #0078d4;
color: white;
border: none;
padding: 8px 16px;
border-radius: 4px;
font-weight: bold;
}
QPushButton:hover {
background-color: #106ebe;
}
""")
2. 响应式布局
- 使用QSplitter实现可调整的分割布局
- 自适应窗口大小
- 合理的组件间距和对齐
3. 用户体验优化
- 拖拽时的视觉反馈
- 进度条显示处理进度
- 清晰的状态提示
- 快捷键支持
项目特色
1. 智能识别算法
相比简单的行数统计，本工具能够：
- 正确识别Python的多行字符串
- 区分文档字符串和普通注释
- 处理复杂的注释嵌套情况
- 支持不同的引号格式
2. 性能优化
- 多线程处理，避免界面卡顿
- 内存优化，支持大型项目
- 异常处理，确保程序稳定性
- 编码自动检测，兼容性强
3. 用户友好
- 直观的拖拽操作
- 清晰的结果展示
- 完善的错误提示
- 详细的使用说明
使用场景
1. 项目评估
📊 快速了解项目规模
📈 分析代码质量
📋 生成项目报告
2. 代码审查
🔍 检查注释覆盖率
📝 评估代码文档化程度
⚡ 识别冗余代码
3. 团队协作
👥 统一代码规范
📊 制定开发计划
🎯 设定质量目标
安装和使用
环境要求
- Python 3.6+
- PyQt5
安装步骤
# 1. 克隆项目
git clone [项目地址]
# 2. 安装依赖
pip install PyQt5
# 3. 运行程序
python code_counter.py
使用方法
- 启动程序
- 拖拽文件或目录到拖拽区域
- 查看统计结果
- 导出报告（可选）
技术难点与解决方案
1. 多行字符串识别
难点: Python的多行字符串可能跨越多行，需要正确识别开始和结束位置。
解决方案: 使用状态机模式，跟踪当前是否在多行字符串内部。
2. 编码问题
难点: Python文件可能使用不同的编码格式。
解决方案: 优先使用UTF-8，失败时使用errors='ignore'参数。
3. 性能优化
难点: 大型项目包含大量文件，可能导致界面卡顿。
解决方案: 使用QThread进行后台处理，通过信号更新界面。
未来规划
短期目标
- 支持更多编程语言
- 添加代码复杂度分析
- 支持自定义统计规则
长期目标
- 集成版本控制系统
- 添加代码质量评分
- 支持团队协作功能
总结
通过这个项目，我们成功打造了一款功能完整、界面美观的代码统计工具。项目展示了：
- PyQt5的强大功能 - 从基础组件到高级特性
- Python的实用性 - 快速原型开发到产品级应用
- 软件工程思维 - 需求分析、架构设计、用户体验
这不仅仅是一个工具，更是一次完整的软件开发实践。希望这个项目能够为你的开发工作带来便利，也希望能够启发你创造出更多有用的工具。
开源地址
项目已开源，欢迎Star和Fork：
GitHub项目地址
如果你有任何问题或建议，欢迎在Issues中讨论！
关键词: Python, PyQt5, GUI开发, 代码统计, 开源工具
标签: #Python #PyQt5 #GUI #开发工具 #代码统计
希望对初学者有帮助；致力于办公自动化的小小程序员一枚
希望能得到大家的【❤️一个免费关注❤️】感谢！
求个 🤞 关注 🤞 +❤️ 喜欢 ❤️ +👍 收藏 👍
此外还有办公自动化专栏，欢迎大家订阅：Python办公自动化专栏
此外还有爬虫专栏，欢迎大家订阅：Python爬虫基础专栏
此外还有Python基础专栏，欢迎大家订阅：Python基础学习专栏
