简介：本资源是一套面向高校人工智能与医学信息工程方向本科生的毕业设计级舌苔识别系统，聚焦深度学习在中医舌诊图像分析中的落地应用，解决舌象特征自动提取与病理状态判别问题。压缩包共131个文件，含26个核心Python源码（涵盖CNN模型构建、迁移学习训练、PyQt GUI逻辑）、6个预训练.pth模型、2个.ui界面文件、7个示例舌象.jpg/png图像、5个配置与元数据.json文件，以及包含TensorBoard日志events.out.tfevents在内的完整训练过程记录，整体大小为105.67MB。已有68人下载学习，适合作为机器学习课程综合实践或医学AI入门研究课题。使用者可直接运行GUI进行舌象上传与实时分析，复现端到端识别流程；获得模块化代码架构、多维度评估指标实现（准确率/召回率）、模型再训练接口及配套学术论文，具备教学示范性与科研可扩展性。
1. 项目缘起：为什么需要一个舌苔识别的桌面工具？
作为一名长期在医疗AI交叉领域摸爬滚打的开发者，我见过太多优秀的算法模型最终“烂”在了实验室的服务器里。医生或研究人员拿到一个识别准确率高达95%的舌苔分类模型，兴奋之余，下一个问题往往是：“我该怎么用？总不能每次都让我打开命令行，输入一堆Python命令吧？” 这正是我决定动手实现这个“基于Python的深度学习舌苔识别系统GUI”的核心动机。这个项目的价值，远不止于把模型预测结果用窗口展示出来那么简单，它关乎如何将前沿的深度学习技术，真正“落地”到中医诊断、健康管理乃至日常科普的桌面应用场景中，让非技术背景的用户也能一键操作，直观地获得专业级的分析结果。
从技术栈来看，这个项目完美地串联了当前AI应用开发的几个关键热词：Python作为粘合剂，深度学习模型作为核心大脑，GUI作为友好交互的界面。它不是一个炫技的玩具，而是一个具备完整输入、处理、输出流程的实用工具。想象一下，一位中医师在问诊时，可以快速拍摄患者的舌苔照片，通过这个桌面工具实时分析舌苔的色泽、厚薄、润燥等特征，并结合模型给出的概率分布，辅助形成更客观的诊断记录。这比单纯依靠肉眼观察和经验判断，无疑是一个巨大的进步。
在开始动手之前，我们需要明确这个系统的核心构成。它本质上是一个标准的AI应用流水线：图像输入 -> 预处理 -> 模型推理 -> 结果解析与展示。GUI的作用，就是为这条流水线的每一个环节提供一个可视化的操作入口和结果反馈窗口。因此，我们的工作将围绕如何用Python高效地搭建这条流水线，并为其披上一件直观、易用的“外衣”来展开。接下来，我将从环境搭建、模型处理、界面设计到最终集成，一步步拆解实现过程，并分享其中我踩过的坑和总结的经验。
2. 环境搭建与核心库选型：避开版本地狱的陷阱
任何Python项目的开端，都是一个稳定、可控的虚拟环境。对于深度学习项目，这一点尤为重要。不同版本的PyTorch、TensorFlow对CUDA和cuDNN的依赖天差地别，直接使用系统Python环境无异于埋雷。我强烈推荐使用Conda来管理环境，它能很好地处理Python本身、深度学习框架以及一些底层C++库的依赖关系。
2.1 创建并配置专属Conda环境
首先，我们创建一个名为tongue_gui的新环境，并指定Python版本。目前PyTorch对Python 3.8-3.10的支持最为成熟，这里我选择3.9。
conda create -n tongue_gui python=3.9 conda activate tongue_gui环境激活后，便是核心库的安装。这里的选择直接决定了后续开发的顺畅程度。
深度学习框架：PyTorch这是我们的模型承载基石。访问PyTorch官网（https://pytorch.org/get-started/locally/），利用其提供的配置生成器选择适合你电脑CUDA版本的命令。如果你的显卡不支持CUDA或不想折腾，就选择CPU版本。例如，对于CUDA 11.8的用户：
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118GUI框架：PyQt5 与 Qt Designer在Tkinter、PyQt、wxPython等众多GUI库中，我选择了PyQt5。原因有三：其一，功能强大，组件丰富，能做出非常专业的界面；其二，拥有Qt Designer这个可视化拖拽布局工具，极大提升开发效率；其三，其信号与槽的机制非常清晰，适合处理复杂的用户交互。
pip install PyQt5 pip install PyQt5-tools # 这个包包含了Qt Designer等工具注意：
PyQt5-tools在某些系统或新版本中可能安装不顺利。如果遇到问题，可以尝试从第三方源下载对应的wheel文件，或者考虑使用pyqt5-tools的替代安装方式。这是第一个小坑。图像处理与可视化OpenCV和Pillow是处理图像输入、预处理和显示的黄金搭档。Matplotlib则用于在GUI中绘制一些分析图表，比如概率分布条形图。
pip install opencv-python pillow matplotlib其他辅助工具
numpy是数值运算的基础，scikit-learn可能用于一些简单的后处理或评估（尽管模型推理本身不需要），albumentations是一个强大的图像增强库，如果你计划在工具内集成数据增强功能会很有用。pip install numpy scikit-learn albumentations
2.2 验证环境与工具准备
安装完成后，写一个简单的脚本来验证关键库是否就位：
import torch import cv2 import PyQt5 print(f"PyTorch版本: {torch.__version__}, CUDA是否可用: {torch.cuda.is_available()}") print(f"OpenCV版本: {cv2.__version__}") print(f"PyQt5版本: {PyQt5.QtCore.PYQT_VERSION_STR}")如果一切正常，输出会显示版本信息，并且CUDA可用的话会返回True。接下来，找到Qt Designer的位置。通常它会在%Python安装路径%\Lib\site-packages\qt5_applications\Qt\bin\designer.exe或类似路径下。为它创建一个桌面快捷方式，这将是我们设计界面的主要战场。
3. 模型准备与推理引擎封装：从训练到部署的桥梁
GUI是脸面，模型才是灵魂。我们假设你已经有了一个训练好的舌苔分类模型，格式可能是PyTorch的.pth或.pt文件，也可能是ONNX格式。这里我以最常用的PyTorch模型为例。
3.1 模型加载与预处理标准化
首先，你需要明确模型训练时所用的预处理流程。这通常包括：图像尺寸调整（Resize）、归一化（Normalize，例如用ImageNet的均值和标准差）、以及转换为Tensor。我们必须严格复现这个流程，否则模型性能会严重下降。
我通常会创建一个单独的model_handler.py文件来封装所有模型相关的操作：
import torch import torch.nn as nn from torchvision import transforms from PIL import Image import cv2 import numpy as np class TongueModelHandler: def __init__(self, model_path, class_names, device='cuda'): """ 初始化模型处理器。 Args: model_path: 训练好的模型文件路径（.pth） class_names: 类别名称列表，如 ['normal', 'white_coating', 'yellow_coating', 'greasy'] device: 推理设备，'cuda' 或 'cpu' """ self.device = torch.device(device if torch.cuda.is_available() and device=='cuda' else 'cpu') self.class_names = class_names # 1. 加载模型结构 # 注意：这里需要你根据训练时的模型类来定义或导入。 # 假设你的模型类定义在另一个文件 `model.py` 中，名为 `TongueNet` from model import TongueNet self.model = TongueNet(num_classes=len(class_names)) # 2. 加载训练好的权重 checkpoint = torch.load(model_path, map_location=self.device) # 处理可能存在的键名不匹配，例如权重保存在 'state_dict' 键下 if 'state_dict' in checkpoint: self.model.load_state_dict(checkpoint['state_dict']) else: self.model.load_state_dict(checkpoint) self.model.to(self.device) self.model.eval() # 设置为评估模式，关闭Dropout等层 # 3. 定义与训练时一致的预处理变换 self.transform = transforms.Compose([ transforms.Resize((224, 224)), # 假设训练时输入为224x224 transforms.ToTensor(), transforms.Normalize(mean=[0.485, 0.456, 0.406], std=[0.229, 0.224, 0.225]) # ImageNet标准 ]) def predict(self, image_path): """ 对单张图片进行预测。 Args: image_path: 图片文件路径 Returns: dict: 包含预测类别、置信度、所有类别概率等信息的字典 """ # 使用PIL打开图片，确保是RGB格式 img_pil = Image.open(image_path).convert('RGB') # 应用预处理 input_tensor = self.transform(img_pil) # 增加一个批次维度 [C, H, W] -> [1, C, H, W] input_batch = input_tensor.unsqueeze(0).to(self.device) # 禁用梯度计算，加速推理 with torch.no_grad(): output = self.model(input_batch) # 获取概率（使用Softmax） probabilities = torch.nn.functional.softmax(output[0], dim=0) # 获取最高置信度的类别索引和分数 confidence, predicted_idx = torch.max(probabilities, 0) confidence = confidence.item() predicted_idx = predicted_idx.item() # 构建结果字典 result = { 'predicted_class': self.class_names[predicted_idx], 'confidence': confidence, 'all_probabilities': {name: prob.item() for name, prob in zip(self.class_names, probabilities)} } return result实操心得：模型加载部分最容易出错的地方是状态字典的键名匹配。如果你的模型在训练时使用了
nn.DataParallel进行多GPU训练，保存的权重键名会带有module.前缀。直接用上述代码加载会报错“Missing keys”。解决方法是在加载后对键名进行修剪：# 在加载state_dict之前或之后处理 if 'state_dict' in checkpoint: state_dict = checkpoint['state_dict'] # 移除 'module.' 前缀 from collections import OrderedDict new_state_dict = OrderedDict() for k, v in state_dict.items(): name = k[7:] if k.startswith('module.') else k new_state_dict[name] = v self.model.load_state_dict(new_state_dict)
3.2 处理ONNX模型以提升兼容性
如果你希望最终的应用不依赖PyTorch环境，或者追求更极致的推理速度（特别是在CPU上），可以考虑将模型转换为ONNX格式。ONNX是一个开放的模型表示标准，可以被多种推理引擎（如ONNX Runtime, OpenVINO）高效运行。
使用PyTorch导出ONNX模型：
import torch # ... 假设已有加载好的model和样例输入dummy_input dummy_input = torch.randn(1, 3, 224, 224).to(device) onnx_path = "tongue_model.onnx" torch.onnx.export(model, dummy_input, onnx_path, input_names=['input'], output_names=['output'], dynamic_axes={'input': {0: 'batch_size'}, 'output': {0: 'batch_size'}}, opset_version=13)然后，你可以使用ONNX Runtime进行推理，这通常比直接运行PyTorch模型在CPU上更快：
import onnxruntime as ort import numpy as np class ONNXModelHandler: def __init__(self, onnx_path, class_names): self.class_names = class_names # 创建推理会话，可以指定使用CPU或GPU providers = ['CUDAExecutionProvider', 'CPUExecutionProvider'] if ort.get_device()=='GPU' else ['CPUExecutionProvider'] self.session = ort.InferenceSession(onnx_path, providers=providers) self.input_name = self.session.get_inputs()[0].name def predict(self, image_path): # ... 同样的预处理，得到numpy数组 input_np，形状为 [1, 3, 224, 224] input_np = preprocessed_image.numpy() outputs = self.session.run(None, {self.input_name: input_np}) probabilities = torch.nn.functional.softmax(torch.tensor(outputs[0][0]), dim=0) # ... 后续处理与PyTorch版本相同4. GUI界面设计与功能实现：用PyQt5构建专业前端
有了强大的模型后端，我们现在需要一个美观易用的前端。使用Qt Designer进行界面原型设计，再通过PyQt5代码将逻辑与界面绑定，这是最高效的工作流。
4.1 使用Qt Designer进行界面布局
打开Qt Designer，你会看到一个空白的窗口。我们的舌苔识别工具界面可以包含以下区域：
- 菜单栏/工具栏：提供“文件”->“打开图片”、“退出”等基本操作。
- 图像显示区域：一个大的
QLabel控件，用于显示用户打开的原始舌苔图片。 - 控制面板：一个垂直或水平的布局，包含：
- “打开图片”按钮(
QPushButton) - “开始识别”按钮(
QPushButton) - “清空”按钮(
QPushButton) - 可能还有一个“选择模型”的下拉菜单 (
QComboBox)。
- “打开图片”按钮(
- 结果显示区域：一个
QTextEdit或几个QLabel，用于清晰地展示识别结果，如“诊断结果：厚白苔”、“置信度：92.5%”。 - 概率可视化区域：一个
QWidget，里面用QPainter绘制，或者嵌入一个matplotlib的FigureCanvas，来显示各个类别的概率条形图。
在Qt Designer中，通过拖拽Widgets和Layouts（如QVBoxLayout,QHBoxLayout,QGridLayout）来搭建界面。务必为每个后续需要在代码中操作的控件（如按钮、显示图片的Label）设置一个清晰的对象名称（objectName），例如label_image_display,btn_open_image,text_result。
设计完成后，保存为.ui文件，例如main_window.ui。
4.2 将.ui文件转换为Python代码并编写主程序
PyQt5提供了将.ui文件转换为Python代码的工具pyuic5。在命令行中执行：
pyuic5 -o ui_mainwindow.py main_window.ui这会生成一个ui_mainwindow.py文件，里面定义了界面的UI类，例如Ui_MainWindow。注意：不要直接修改这个生成的文件，因为如果你用Qt Designer调整了界面并重新生成，所有手动修改都会丢失。
正确的做法是创建一个新的主程序文件，例如main.py，在其中继承生成的UI类，并添加我们的业务逻辑。
import sys import os from PyQt5.QtWidgets import QApplication, QMainWindow, QFileDialog, QMessageBox, QLabel from PyQt5.QtCore import Qt, QThread, pyqtSignal from PyQt5.QtGui import QPixmap, QImage import cv2 import numpy as np from ui_mainwindow import Ui_MainWindow # 导入生成的UI类 from model_handler import TongueModelHandler # 导入我们之前写的模型处理器 class PredictionThread(QThread): """ 用于在后台执行模型预测的线程，防止界面卡死 """ prediction_finished = pyqtSignal(dict) # 定义一个信号，用于传递预测结果 def __init__(self, model_handler, image_path): super().__init__() self.model_handler = model_handler self.image_path = image_path def run(self): # 在这里执行耗时的预测任务 result = self.model_handler.predict(self.image_path) self.prediction_finished.emit(result) # 发射信号 class MainWindow(QMainWindow): def __init__(self): super().__init__() # 初始化UI self.ui = Ui_MainWindow() self.ui.setupUi(self) # 初始化模型处理器（假设模型文件在同目录下） self.class_names = ['正常舌', '白苔', '黄苔', '腻苔'] self.model_handler = TongueModelHandler('best_model.pth', self.class_names, device='cpu') # 先用CPU测试 # 连接信号与槽 self.ui.btn_open_image.clicked.connect(self.open_image) self.ui.btn_start_predict.clicked.connect(self.start_prediction) self.ui.btn_clear.clicked.connect(self.clear_all) # 初始化状态变量 self.current_image_path = None # 设置一些UI初始状态 self.ui.label_image_display.setText("请打开一张舌苔图片") self.ui.label_image_display.setAlignment(Qt.AlignCenter) def open_image(self): """ 打开图片文件并显示在Label上 """ file_path, _ = QFileDialog.getOpenFileName( self, "选择舌苔图片", "", "Image Files (*.png *.jpg *.jpeg *.bmp)" ) if file_path: self.current_image_path = file_path # 使用OpenCV读取图片，因为后续预处理可能用到 img_cv = cv2.imread(file_path) if img_cv is None: QMessageBox.warning(self, "错误", "无法读取图片文件！") return # 将BGR转换为RGB img_rgb = cv2.cvtColor(img_cv, cv2.COLOR_BGR2RGB) # 调整图片大小以适应Label，同时保持宽高比 h, w, ch = img_rgb.shape # 假设我们的显示Label大小是640x480 target_width = self.ui.label_image_display.width() target_height = self.ui.label_image_display.height() scale = min(target_width / w, target_height / h) new_w, new_h = int(w * scale), int(h * scale) img_resized = cv2.resize(img_rgb, (new_w, new_h)) # 将numpy数组转换为QImage，再转换为QPixmap显示 bytes_per_line = ch * new_w q_img = QImage(img_resized.data, new_w, new_h, bytes_per_line, QImage.Format_RGB888) pixmap = QPixmap.fromImage(q_img) self.ui.label_image_display.setPixmap(pixmap) self.ui.label_image_display.setAlignment(Qt.AlignCenter) # 清空之前的结果 self.ui.text_result.clear() def start_prediction(self): """ 开始预测 """ if not self.current_image_path: QMessageBox.information(self, "提示", "请先打开一张图片！") return # 禁用预测按钮，防止重复点击 self.ui.btn_start_predict.setEnabled(False) self.ui.text_result.setText("模型正在分析中，请稍候...") # 创建并启动预测线程 self.prediction_thread = PredictionThread(self.model_handler, self.current_image_path) self.prediction_thread.prediction_finished.connect(self.on_prediction_finished) self.prediction_thread.start() def on_prediction_finished(self, result): """ 接收预测结果并更新UI """ # 恢复按钮状态 self.ui.btn_start_predict.setEnabled(True) # 显示结果 result_text = f"诊断结果：{result['predicted_class']}\n" result_text += f"置信度：{result['confidence']*100:.2f}%\n\n" result_text += "各类别概率：\n" for cls, prob in result['all_probabilities'].items(): result_text += f" {cls}: {prob*100:.2f}%\n" self.ui.text_result.setText(result_text) # 这里可以添加调用函数来更新概率可视化图表 # self.update_probability_chart(result['all_probabilities']) def clear_all(self): """ 清空图片和结果 """ self.current_image_path = None self.ui.label_image_display.clear() self.ui.label_image_display.setText("请打开一张舌苔图片") self.ui.label_image_display.setAlignment(Qt.AlignCenter) self.ui.text_result.clear() # 可以添加一个用于更新图表的函数 # def update_probability_chart(self, prob_dict): # # 使用matplotlib绘制条形图，并嵌入到Qt界面中 # pass if __name__ == '__main__': app = QApplication(sys.argv) window = MainWindow() window.show() sys.exit(app.exec_())4.3 关键细节与避坑指南
图像显示与缩放：直接使用
QPixmap(file_path)加载大图片可能会导致内存问题或显示不全。我推荐使用上述方法，通过OpenCV/PIL读取并缩放到合适尺寸后再转换，可以更好地控制显示效果和性能。防止界面卡顿：使用多线程。模型推理，尤其是深度学习模型推理，是一个耗时操作。如果在主UI线程中直接调用
model.predict()，界面会“冻住”，直到推理完成。使用QThread将耗时任务放到后台线程是标准做法。注意，所有UI操作（如更新Label文本）都必须在主线程中完成。我们通过自定义信号pyqtSignal将后台线程的结果传递回主线程。资源管理：在程序退出时，确保释放模型、线程等资源。对于
QThread，可以设置thread.finished.connect(thread.deleteLater)来确保线程对象被正确清理。打包与分发：当你完成开发，想将工具分享给没有Python环境的用户时，需要使用打包工具。PyInstaller是目前最常用的选择。但打包PyQt5+PyTorch的应用是一个大坑。你需要创建一个spec文件，手动添加PyTorch、TorchVision等库的隐藏依赖。一个基本的命令是：
pyinstaller --onefile --windowed --add-data "best_model.pth;." --hidden-import torch --hidden-import torchvision main.py更可靠的做法是编写一个
.spec文件，在其中精确指定所有二进制依赖和动态链接库的路径。
5. 功能扩展与性能优化思路
一个基础的单图片识别工具已经完成。但要让其更具实用价值，我们可以从以下几个方向进行扩展：
5.1 批量处理与历史记录
为工具添加“打开文件夹”功能，遍历文件夹内所有图片进行批量识别，并将结果（文件名、诊断结果、置信度）导出为CSV或Excel文件。这非常适合用于处理一批患者的舌苔影像资料。
在GUI中，可以增加一个QListWidget来显示已处理文件的列表，并允许用户点击查看任意一张的历史识别结果。这需要将每次识别的图片路径和结果保存到一个小型数据库（如SQLite）或本地JSON文件中。
5.2 图像预处理增强
在识别前，允许用户或自动对图片进行一些预处理，以提升模型表现。例如：
- ROI选取：让用户拖动矩形框，只识别舌体部分，排除嘴唇、牙齿等干扰区域。
- 颜色校正：由于拍摄环境光不同，舌色可能偏差。可以集成简单的白平衡算法或颜色校正功能。
- 图像增强：提供对比度、亮度调整滑块，让用户微调图像，观察模型结果的变化，这本身也是一个理解模型的好方法。
这些功能可以通过OpenCV的交互式操作（如鼠标事件回调）和实时图像刷新来实现。
5.3 模型可解释性集成
“黑箱”模型的结果往往难以让人完全信服。可以集成一些简单的可解释性方法，如Grad-CAM（梯度加权类激活映射）。在预测完成后，除了显示类别，还可以生成一张热力图，叠加在原图上，高亮显示模型做出判断所依据的舌苔区域（例如，是舌根还是舌边影响了“黄苔”的判断）。这能极大增加结果的透明度和可信度，对于辅助诊断场景尤为重要。
实现Grad-CAM需要获取模型中间层的特征图和梯度。你需要修改模型类，使其在推理时能保留这些信息。虽然有一定工作量，但带来的价值是巨大的。
5.4 性能优化：模型轻量化与推理加速
如果发现工具运行缓慢，尤其是使用CPU时，可以考虑以下优化：
- 模型量化：使用PyTorch的量化功能，将模型权重从FP32转换为INT8，可以显著减少模型大小并提升CPU推理速度，而精度损失通常很小。
# 动态量化示例 import torch.quantization quantized_model = torch.quantization.quantize_dynamic( model, {torch.nn.Linear}, dtype=torch.qint8 ) - 使用更快的推理后端：如前所述，将模型转换为ONNX，并使用ONNX Runtime进行推理，在CPU上通常比原生PyTorch快。
- 启用GPU加速：确保你的PyTorch或ONNX Runtime安装了CUDA版本，并在初始化模型处理器时指定
device='cuda'。对于有NVIDIA显卡的用户，这将是速度提升最明显的一步。 - 图片预处理流水线优化：将多次图像变换操作合并，或使用更高效的库（如
cv2代替部分PIL操作）。
6. 从开发到部署：打包与分发实战
让用户双击一个.exe文件就能运行，是桌面应用的最后一步，也是最容易出问题的一步。
6.1 使用PyInstaller进行打包
首先，安装PyInstaller：pip install pyinstaller。
一个复杂的PyQt5+PyTorch应用，直接使用命令行参数可能会遗漏很多依赖。最佳实践是创建一个打包脚本build.spec：
# build.spec a = Analysis(['main.py'], pathex=[], binaries=[], datas=[('best_model.pth', '.'), ('class_names.txt', '.')], # 添加数据文件 hiddenimports=['torch', 'torchvision', 'PIL', 'PIL._imaging', 'cv2', 'numpy.core._multiarray_umath'], hookspath=[], runtime_hooks=[], excludes=[], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None, noarchive=False) pyz = PYZ(a.pure, a.zipped_data, cipher=None) exe = EXE(pyz, a.scripts, a.binaries, a.zipfiles, a.datas, [], name='TongueDiagnosisAssistant', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, upx_exclude=[], runtime_tmpdir=None, console=False, # 设置为True可以显示控制台，便于调试 icon='tongue.ico') # 可指定应用图标 coll = COLLECT(exe, a.binaries, a.zipfiles, a.datas, strip=False, upx=True, upx_exclude=[], name='TongueDiagnosisAssistant')关键点在于hiddenimports和datas。PyInstaller的自动依赖分析经常漏掉PyTorch、OpenCV的一些子模块，需要手动添加。datas用于将模型文件、配置文件等非代码资源打包进去。
然后运行打包命令：
pyinstaller build.spec6.2 打包后的测试与问题排查
打包生成的.exe文件通常在dist文件夹下。将其复制到一个全新的、没有Python环境的电脑上进行测试是最佳方式。常见问题及解决方案：
- 缺少DLL：运行时提示缺少
*.dll文件。这通常是因为某些二进制依赖（如PyTorch的CUDA库）没有被正确打包。你需要找到这些DLL（通常在torch\lib或CUDA安装目录\bin下），并将其路径添加到spec文件的binaries列表中。binaries=[('C:/Path/To/torch/lib/*.dll', 'torch/lib')] - 模型文件找不到：程序运行时提示
FileNotFoundError: [Errno 2] No such file or directory: 'best_model.pth'。这是因为打包后，程序的当前工作目录可能改变。在代码中，应该使用sys._MEIPASS（PyInstaller运行时设置的临时解压目录）或os.path.join(os.path.dirname(__file__), 'best_model.pth')来构建资源文件的绝对路径。def resource_path(relative_path): """ 获取打包后资源的绝对路径 """ try: base_path = sys._MEIPASS except Exception: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) model_path = resource_path('best_model.pth') - 界面样式丢失：PyQt5应用在某些系统上可能没有默认样式，看起来非常老旧。可以在主程序开头添加以下代码来强制使用Fusion风格，这是一个跨平台、外观现代的风格。
from PyQt5.QtWidgets import QApplication import sys app = QApplication(sys.argv) app.setStyle('Fusion')
经过以上步骤，你应该得到了一个功能完整、界面友好、可以独立分发的舌苔识别桌面应用。这个过程不仅适用于舌苔识别，任何“深度学习模型 + 桌面GUI”的应用开发，其核心架构和踩坑经验都是相通的。从模型封装、界面响应、多线程处理到最终打包，每一个环节都需要对工具链有深入的理解和细致的调试。希望这篇详尽的拆解，能为你实现自己的AI桌面应用提供一个坚实的起点。
本文还有配套的精品资源，点击获取
