如何在PyQt5 Python项目中导入9页PDF课程理论报告？

刚好做过类似的需求，给你分享几个靠谱的实现思路，针对9页的PDF完全够用，你可以根据自己的需求选：

方案1：PyMuPDF（fitz）+ PyQt5 自定义渲染 #

这个方案灵活性最高，适合需要对PDF内容做自定义展示（比如添加标注、调整显示样式）的场景，原理是把PDF每页转成图片，再用PyQt的控件展示。

步骤： #

1. 先安装依赖：

pip install pymupdf PyQt5

2. 示例代码（带翻页功能的简单窗口）：

import sys
import fitz
from PyQt5.QtWidgets import (QApplication, QMainWindow, QWidget, 
                             QVBoxLayout, QPushButton, QLabel, QScrollArea)
from PyQt5.QtGui import QPixmap, QImage

class PDFViewer(QMainWindow):
    def __init__(self, pdf_path):
        super().__init__()
        self.pdf_path = pdf_path
        self.doc = fitz.open(pdf_path)
        self.current_page = 0
        self.init_ui()
        self.show_page()

    def init_ui(self):
        self.setWindowTitle("理论报告查看器")
        self.setGeometry(100, 100, 800, 600)
        
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout(central_widget)
        
        # 滚动区域显示PDF页面
        self.scroll_area = QScrollArea()
        self.page_label = QLabel()
        self.scroll_area.setWidget(self.page_label)
        self.scroll_area.setWidgetResizable(True)
        layout.addWidget(self.scroll_area)
        
        # 翻页按钮
        btn_layout = QVBoxLayout()
        self.prev_btn = QPushButton("上一页")
        self.prev_btn.clicked.connect(self.prev_page)
        self.next_btn = QPushButton("下一页")
        self.next_btn.clicked.connect(self.next_page)
        btn_layout.addWidget(self.prev_btn)
        btn_layout.addWidget(self.next_btn)
        layout.addLayout(btn_layout)

    def show_page(self):
        if 0 <= self.current_page < len(self.doc):
            page = self.doc.load_page(self.current_page)
            pix = page.get_pixmap(dpi=150)  # 调整dpi控制清晰度
            q_img = QImage(pix.samples, pix.width, pix.height, pix.stride, QImage.Format_RGB888)
            self.page_label.setPixmap(QPixmap.fromImage(q_img))
            self.setWindowTitle(f"理论报告查看器 - 第{self.current_page+1}/{len(self.doc)}页")

    def prev_page(self):
        if self.current_page > 0:
            self.current_page -= 1
            self.show_page()

    def next_page(self):
        if self.current_page < len(self.doc)-1:
            self.current_page += 1
            self.show_page()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    viewer = PDFViewer("your_theory_report.pdf")  # 替换成你的PDF路径
    viewer.show()
    sys.exit(app.exec_())

方案2：QWebEngineView 快速集成（最简单） #

如果你不需要自定义渲染，只是想快速让用户查看PDF，这个方案最省心——利用PyQt5的网页控件直接加载PDF，自带缩放、翻页、搜索等阅读器基础功能。

步骤： #

1. 安装webengine模块（如果没装的话）：

pip install PyQt5-webengine

2. 示例代码：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5.QtWebEngineWidgets import QWebEngineView
from PyQt5.QtCore import QUrl

class PDFViewer(QMainWindow):
    def __init__(self, pdf_path):
        super().__init__()
        self.setWindowTitle("理论报告查看器")
        self.setGeometry(100, 100, 800, 600)
        
        self.web_view = QWebEngineView()
        self.setCentralWidget(self.web_view)
        # 加载本地PDF文件
        self.web_view.load(QUrl.fromLocalFile(pdf_path))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    viewer = PDFViewer("your_theory_report.pdf")  # 替换成你的PDF路径
    viewer.show()
    sys.exit(app.exec_())

方案3：Poppler-Qt5 专业PDF处理 #

如果需要更专业的PDF操作（比如提取文本、处理注释、矢量渲染），可以用Poppler-Qt5，不过安装门槛稍高：

• Linux：需要先安装系统依赖sudo apt-get install libpoppler-qt5-dev，再装Python绑定pip install poppler-qt5
• Windows：需要下载预编译的Poppler库，再配置环境变量，相对麻烦些

这个方案的优势是支持矢量渲染，放大不会模糊，适合对显示精度要求高的场景。

方案对比&选择建议： #

• 想快速搞定选方案2，代码最少，功能齐全
• 需要自定义展示逻辑（比如加标注、嵌入其他控件）选方案1
• 对PDF精度/专业功能有要求选方案3

9页的PDF不管哪个方案都不会有性能问题，放心用就行~

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