PySide6开发：QTextBrowser在Mac正常渲染Markdown，Windows打包后失效

针对你遇到的Windows环境下QTextBrowser无法渲染Markdown文件（Mac正常）的问题，可尝试以下几种解决方案：

1. 将本地路径转换为Qt兼容的File URL格式 #

Windows系统下，直接传递本地文件路径字符串给setSource可能导致Qt解析异常，需将路径转换为标准的file:///格式URL：

修改app.py中的代码：

import sys
from PySide6.QtCore import QUrl  # 新增导入
from PySide6.QtWidgets import QMainWindow, QApplication

from MainWindow import UiMainWindow
from infrastructure.PathResolver import resolve_path


class MainWindow(QMainWindow, UiMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()
        self.setup_ui(self)
        file_path = resolve_path('data/edu/FecalPositiveRoundworm.md')
        # 转换为Qt兼容的File URL
        self.education_textbox.setSource(QUrl.fromLocalFile(file_path))

QUrl.fromLocalFile()会自动处理跨平台的路径分隔符和格式问题，确保Qt能正确识别文件类型和位置。

2. 直接读取Markdown内容并设置（绕过路径解析） #

如果路径格式调整后仍有问题，可直接读取文件内容，通过setMarkdown方法传递给QTextBrowser，同时显式指定UTF-8编码避免乱码：

修改app.py中的代码：

import sys
from PySide6.QtWidgets import QMainWindow, QApplication

from MainWindow import UiMainWindow
from infrastructure.PathResolver import resolve_path


class MainWindow(QMainWindow, UiMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()
        self.setup_ui(self)
        file_path = resolve_path('data/edu/FecalPositiveRoundworm.md')
        # 读取Markdown内容并设置
        with open(file_path, 'r', encoding='utf-8') as md_file:
            md_content = md_file.read()
        self.education_textbox.setMarkdown(md_content)

这种方式跳过了Qt对文件路径的自动解析，直接传递渲染所需的文本内容，同时确保文件以正确编码读取，避免因编码问题导致的渲染失败。

3. 检查PyInstaller打包时的资源文件配置 #

确保PyInstaller打包时正确包含了data文件夹，避免资源文件缺失：

• 如果使用命令行打包，需添加--add-data参数：

  # Windows系统
  pyinstaller --add-data "data;data" app.py
  # Mac/Linux系统
  pyinstaller --add-data "data:data" app.py
  

• 如果使用spec文件打包，需在datas参数中添加资源路径：

  a = Analysis(
      ['app.py'],
      datas=[('data', 'data')],  # 确保此行存在
      # 其他配置...
  )
  

该配置会将项目根目录下的data文件夹完整复制到打包后的程序资源目录（sys._MEIPASS），保证运行时能正确找到Markdown文件。

内容的提问来源于stack exchange，提问作者Moony