Python代码质量检查与重构建议工具：AST语法树分析函数长度/嵌套深度/参数数量、四级风险颜色编码、质量评分报告一键导出

🖥️ 运行效果

🚀 实例简介

一款基于 Python AST 语法分析的代码质量检查桌面工具，能够自动扫描 Python 源代码文件，检测常见的代码质量问题（函数过长、嵌套过深、参数过多、缺少文档字符串等），并给出针对性的重构建议。支持自动计算质量评分（0-100分），表格化展示所有问题，按严重级别分类显示。

💻 核心代码

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
代码质量检查与重构建议工具
扫描 Python 代码文件，检测常见质量问题（函数过长、嵌套过深、参数过多等），
给出重构建议，生成质量评分报告。
"""

import tkinter as tk
from tkinter import ttk, filedialog, messagebox
import ast
import os
import platform

# 中文字体配置（Linux 服务器使用 WenQuanYi，Windows 使用微软雅黑）
CHINESE_FONT = "WenQuanYi Zen Hei" if platform.system() == "Linux" else "Microsoft YaHei"


class CodeQualityChecker:
    """代码质量检查器"""
    
    def __init__(self):
        self.issues = []
        
    def check_file(self, file_path):
        """检查单个 Python 文件"""
        try:
            with open(file_path, 'r', encoding='utf-8') as f:
                code = f.read()
            
            tree = ast.parse(code)
            self.issues = []
            
            # 遍历所有函数和类
            for node in ast.walk(tree):
                if isinstance(node, ast.FunctionDef):
                    self._check_function(node, code)
                elif isinstance(node, ast.ClassDef):
                    self._check_class(node)
            
            return self.issues
        except Exception as e:
            return [{"type": "error", "message": f"解析失败: {str(e)}", "severity": "error"}]
    
    def _check_function(self, node, code):
        """检查函数质量问题"""
        func_name = node.name
        
        # 1. 检查函数长度（超过 50 行认为过长）
        func_lines = code[node.lineno:node.end_lineno].split('\n')
        if len(func_lines) > 50:
            self.issues.append({
                "type": "函数过长",
                "message": f"函数 {func_name}() 有 {len(func_lines)} 行，建议拆分为多个小函数",
                "severity": "warning",
                "line": node.lineno
            })
        
        # 2. 检查参数数量（超过 5 个参数认为过多）
        if len(node.args.args) > 5:
            self.issues.append({
                "type": "参数过多",
                "message": f"函数 {func_name}() 有 {len(node.args.args)} 个参数，建议使用数据类或字典封装",
                "severity": "warning",
                "line": node.lineno
            })
        
        # 3. 检查嵌套深度（超过 4 层认为过深）
        max_depth = self._calculate_max_depth(node)
        if max_depth > 4:
            self.issues.append({
                "type": "嵌套过深",
                "message": f"函数 {func_name}() 嵌套深度 {max_depth} 层，建议提取子函数或使用早返回",
                "severity": "warning",
                "line": node.lineno
            })
        
        # 4. 检查是否有文档字符串
        if not ast.get_docstring(node):
            self.issues.append({

💡 适用场景

办公自动化、数据分析、快速原型开发