Qt5 中文文档安装手册

📖 前言

由于英语水平有限，且有时可能因网络或环境限制无法使用其他翻译工具，因此翻译了一些基础和常用的Qt类。本手册将帮助您完成Qt5中文文档的安装和配置。

资源https://download.csdn.net/download/weixin_49630770/92237397?spm=1001.2014.3001.5503

---

📑 目录

• 已翻译模块

  • 模块分布统计

• 使用教程

  • 解压目录

  • 目录解析

  • 查找Qt安装路径

  • 更换帮助手册

---

📦 已翻译模块

🎯 模块分布统计

1. Qt Widgets 模块 (138个类)

类别	类名示例	数量	完成度
基础控件	QPushButton, QLabel, QLineEdit, QCheckBox, QRadioButton, QToolButton, QCommandLinkButton	20+	✅ 100%
容器控件	QGroupBox, QTabWidget, QToolBox, QStackedWidget, QScrollArea, QMdiArea, QDockWidget	10+	✅ 100%
输入控件	QSpinBox, QDoubleSpinBox, QSlider, QDial, QComboBox, QDateEdit, QTimeEdit, QDateTimeEdit	15+	✅ 100%
显示控件	QTextEdit, QPlainTextEdit, QTextBrowser, QLCDNumber, QProgressBar, QCalendarWidget	10+	✅ 100%
视图类	QTableView, QListView, QTreeView, QListWidget, QTableWidget, QTreeWidget, QColumnView	10+	✅ 100%
对话框	QDialog, QMessageBox, QFileDialog, QColorDialog, QFontDialog, QInputDialog, QWizard, QPrintDialog	10+	✅ 100%
窗口和工具栏	QMainWindow, QDockWidget, QStatusBar, QMenuBar, QToolBar, QSplitter, QTabBar	15+	✅ 100%
布局管理器	QBoxLayout, QHBoxLayout, QVBoxLayout, QGridLayout, QFormLayout, QStackedLayout, QGraphicsAnchorLayout	8	✅ 100%
手势类	QGesture, QPinchGesture, QPanGesture, QSwipeGesture, QTapGesture, QTapAndHoldGesture	7	✅ 100%
图形效果	QGraphicsEffect, QGraphicsBlurEffect, QGraphicsDropShadowEffect, QGraphicsColorizeEffect, QGraphicsOpacityEffect	5	✅ 100%
图形框架	QGraphicsView, QGraphicsScene, QGraphicsWidget, QGraphicsObject, QGraphicsItem, QGraphicsRotation, QGraphicsScale, QGraphicsAnchor	10+	✅ 100%
数据模型	QAbstractItemModel, QStandardItemModel, QFileSystemModel, QDirModel, QDataWidgetMapper	8	✅ 100%
菜单和动作	QMenu, QMenuBar, QAction, QActionGroup, QContextMenuEvent	6	✅ 100%
样式选项	QStyleOption系列, QStyleOptionFrame, QStylePainter	5+	✅ 100%
其他控件	QUndoView, QScroller, QAbstractButton, QAbstractSlider, QAbstractScrollArea, QKeySequenceEdit	15+	✅ 100%

小计: 138个类 (Qt Widgets核心类全覆盖)

---

2. Qt Core 模块 (52个类)

类别	类名示例	数量	完成度
容器类	QString, QByteArray, QList, QVector, QMap, QHash, QSet, QQueue, QStack, QLinkedList	15+	✅ 100%
元对象系统	QObject, QMetaObject, QMetaType, QVariant, QMetaProperty, QMetaMethod	6	✅ 100%
文件和I/O	QFile, QDir, QFileInfo, QIODevice, QTextStream, QDataStream, QFileDevice, QFileSystemWatcher	10	✅ 100%
JSON/XML	QJsonDocument, QJsonObject, QJsonArray, QJsonValue, QXmlStreamReader, QXmlStreamWriter	6	✅ 100%
网络URL	QUrl, QUrlQuery	2	✅ 100%
线程和同步	QThread, QMutex, QMutexLocker, QReadWriteLock, QSemaphore, QWaitCondition, QThreadPool, QRunnable	10	✅ 100%
智能指针	QSharedPointer, QScopedPointer, QWeakPointer, QPointer, QSharedData	5	✅ 100%
时间和日期	QDateTime, QDate, QTime, QTimer, QTimeLine, QEasingCurve, QElapsedTimer	7	✅ 100%
状态机	QStateMachine, QState, QFinalState, QHistoryState, QEventTransition, QSignalTransition, QAbstractTransition	7	✅ 100%
进程和系统	QProcess, QLibrary, QPluginLoader, QCoreApplication, QCommandLineParser	5	✅ 100%
国际化	QLocale, QTranslator, QCollator	3	✅ 100%
正则表达式	QRegularExpression, QRegularExpressionMatch, QRegularExpressionMatchIterator	3	✅ 100%
其他核心类	QSettings, QMimeType, QMimeData, QModelIndex, QAbstractItemModel, QSortFilterProxyModel, QResource	10+	✅ 100%

小计: 52个类 (Qt Core基础类全覆盖)

---

3. Qt GUI 模块 (32个类)

类别	类名示例	数量	完成度
绘图和渲染	QPainter, QPixmap, QImage, QBitmap, QPicture, QPaintDevice, QPaintEngine	10	✅ 100%
颜色和画笔	QColor, QPen, QBrush, QGradient, QLinearGradient, QRadialGradient, QConicalGradient	7	✅ 100%
字体和文本	QFont, QFontMetrics, QFontInfo, QTextDocument, QTextCursor, QTextFormat	6	✅ 100%
图标和光标	QIcon, QCursor, QPixmapCache	3	✅ 100%
事件处理	QKeyEvent, QMouseEvent, QWheelEvent, QContextMenuEvent, QPaintEvent, QResizeEvent	8	✅ 100%
验证器	QValidator, QIntValidator, QDoubleValidator, QRegExpValidator, QRegularExpressionValidator	5	✅ 100%
其他GUI类	QWindow, QScreen, QClipboard, QDrag, QPointingDeviceUniqueId, QKeySequence	8+	✅ 100%

小计: 32个类 (Qt GUI核心类全覆盖)

---

4. Qt Network 模块 (22个类)

类别	类名示例	数量	完成度
HTTP网络	QNetworkAccessManager ⭐, QNetworkRequest ⭐, QNetworkReply ⭐, QHttpMultiPart, QHttpPart	5	✅ 100% 深度翻译
套接字类	QAbstractSocket, QTcpSocket ⭐, QTcpServer, QUdpSocket ⭐, QLocalSocket ⭐, QLocalServer ⭐	6	✅ 100%
SSL/TLS	QSslSocket ⭐, QSslCertificate ⭐, QSslConfiguration, QSslError, QSslKey, QSslCipher	6	✅ 100%
网络工具	QHostAddress, QHostInfo ⭐, QNetworkProxy ⭐, QNetworkProxyQuery, QNetworkProxyFactory	5	✅ 100%
Cookie和缓存	QNetworkCookie ⭐, QNetworkCookieJar, QNetworkDiskCache, QAbstractNetworkCache	4	✅ 100%
DNS和其他	QDnsLookup ⭐, QNetworkInterface, QNetworkAddressEntry	3	✅ 100%

小计: 22个类 (Qt Network核心类全覆盖，⭐标记为深度翻译)

---

5. Qt Multimedia 模块 (13个类)

类别	类名示例	数量	完成度
播放器	QMediaPlayer ⭐, QVideoWidget, QAudioOutput	3	✅ 100% 深度翻译
录制器	QMediaRecorder, QAudioRecorder, QCameraImageCapture	3	✅ 100%
音效	QSoundEffect, QAudioDecoder	2	✅ 100%
相机控制	QCamera, QCameraExposure, QCameraFocus, QCameraImageProcessing	4	✅ 100%
收音机	QRadioTuner, QRadioData	2	✅ 100%
图形视频	QGraphicsVideoItem, QAbstractVideoFilter	2	✅ 100%

小计: 13个类 (Qt Multimedia核心类全覆盖，⭐标记为深度翻译)

---

6. Qt SQL 模块 (4个类)

类别	类名示例	数量	完成度
数据库访问	QSqlDatabase ⭐, QSqlQuery ⭐	2	✅ 100%
数据模型	QSqlTableModel ⭐, QSqlQueryModel	2	✅ 100% 深度翻译

小计: 4个类 (Qt SQL核心类全覆盖，⭐标记为深度翻译)

---

7. Qt SerialPort 模块 (1个类)

类别	类名示例	数量	完成度
串口通信	QSerialPort ⭐	1	✅ 100% 深度翻译

小计: 1个类 (Qt SerialPort主要类，⭐标记为深度翻译)

---

8. Qt SVG 模块 (3个类)

类别	类名示例	数量	完成度
SVG处理	QSvgGenerator, QSvgRenderer, QGraphicsSvgItem	3	✅ 100%

小计: 3个类 (Qt SVG核心类全覆盖)

---

9. Qt Sensors 模块 (1个类)

类别	类名示例	数量	完成度
传感器	QSensor ⭐	1	✅ 100% 深度翻译

小计: 1个类 (Qt Sensors基类，⭐标记为深度翻译)

---

10. Qt Positioning 模块 (1个类)

类别	类名示例	数量	完成度
地理定位	QGeoPositionInfoSource	1	✅ 100%

小计: 1个类 (Qt Positioning核心类)

---

11. Qt Help 模块 (1个类)

类别	类名示例	数量	完成度
帮助系统	QHelpEngineCore	1	✅ 100%

小计: 1个类 (Qt Help核心类)

---

12. Qt PrintSupport 模块 (1个类)

类别	类名示例	数量	完成度
打印支持	QPrintDialog	1	✅ 100%

小计: 1个类 (Qt PrintSupport核心类)

---

13. Qt XML 模块 (2个类)

类别	类名示例	数量	完成度
XML处理	QDomDocument, QDomElement	2	✅ 100%

小计: 2个类 (Qt XML核心类)

---

14. Qt Concurrent 模块 (2个类)

类别	类名示例	数量	完成度
并发编程	QtConcurrent, QFuture, QFutureWatcher	2+	✅ 90%

小计: 2个类 (Qt Concurrent核心类)

---

15. Qt Test 模块 (1个类)

类别	类名示例	数量	完成度
单元测试	QTest	1	✅ 100%

小计: 1个类 (Qt Test核心类)

---

16. Qt DBus 模块 (2个类)

类别	类名示例	数量	完成度
进程间通信	QDBusConnection, QDBusMessage	2	✅ 90%

小计: 2个类 (Qt DBus核心类)

---

📚 使用教程

解压目录

下载压缩包后，将其解压到您选择的位置。

解压前：

解压后：

---

目录解析

打开解压后的目录，您会看到以下文件：

主要文件类型说明

文件类型	作用说明
.qch	Qt帮助系统文件格式，由.qhp文件生成，而.qhp又基于.html文件生成。生成工具为qhelpgenerator.exe，位于Qt安装目录下
.ps1	PowerShell脚本文件。generate_qch.ps1脚本封装了.qhp和.qch文件的生成流程
.py	Python脚本文件，功能与.ps1脚本一致。需要安装Python环境，而.ps1脚本Windows系统默认支持

使用 generate_qch.ps1 脚本

该脚本会在以下常见路径中自动查找qhelpgenerator.exe工具：

 C:\Qt\Qt5.12.12\5.12.12\mingw73_64\bin\qhelpgenerator.exe
 C:\Qt\Qt5.12.12\5.12.12\msvc2017_64\bin\qhelpgenerator.exe
 C:\Qt\Qt5.12.12\5.12.12\msvc2015_64\bin\qhelpgenerator.exe
 C:\Qt\5.12.12\mingw73_64\bin\qhelpgenerator.exe
 C:\Qt\5.12.12\msvc2017_64\bin\qhelpgenerator.exe
 C:\Qt\Tools\QtCreator\bin\qhelpgenerator.exe

如果上述路径都未找到，您也可以直接修改脚本中的Qt安装路径，或使用以下命令指定路径：

 # 增量生成（只生成需要更新的文件）
 .\generate_qch.ps1
 ​
 # 强制重新生成所有文件
 .\generate_qch.ps1 -Force
 ​
 # 指定 qhelpgenerator 路径
 .\generate_qch.ps1 -QHelpGenerator "C:\Qt\5.12.12\mingw73_64\bin\qhelpgenerator.exe"

⚠️ 重要提示： 上述生成操作仅在HTML文件发生改变时才有必要执行。如果您自行翻译了HTML文件并需要更新，才需要执行上述操作。对于直接使用本项目，您只需要使用已提供的.qch文件即可，无需执行生成操作。

---

查找Qt安装路径

前提条件： 已安装Qt

方法说明

本方法适用于Windows系统。其他系统可以搜索相应的方法，Windows系统也可以通过网络搜索找到其他方法。

详细步骤

步骤1： 首先在桌面查找Qt快捷方式图标

如果桌面上没有找到Qt快捷图标，则需要通过Windows开始菜单进行查找。

步骤2： 打开Windows开始菜单

步骤3： 在所有程序中查找

提示： 注意并不是所有程序都会显示在这里。

步骤4： 继续向下查找，找到Qt程序组

步骤5： 打开Qt程序组，找到Qt Creator

注意： 您的Qt版本可能与我不同，但操作流程基本相同。

步骤6： 右键点击Qt Creator，选择"属性"

步骤7： 点击"打开文件所在的位置"，进入安装目录

步骤8： 在导航栏中选择Qt5的目录

步骤9： 返回到Qt5目录中

步骤10： 选择版本号目录（如5.12.12）点击进入

💡 提示： 到此步骤已经足够了。您可以复制或备份这个目录路径，然后在下一步中进行替换操作。

---

更换帮助手册

操作步骤

步骤1： 关闭Qt Creator（如果正在运行）

更换文档目录后，需要重新进入Qt Creator。如果Qt Creator正在运行，请先关闭它，然后重新启动。

步骤2： 打开Qt Creator主界面

步骤3： 进入选项设置

点击菜单栏 工具 → 选项，如图所示：

步骤4： 配置帮助文档

在左侧菜单中选择 帮助 → Documentation，如图所示：

步骤5： 添加文档路径

如果第三个框（文档列表）为空，点击 Add 或 添加 按钮。如果已有内容，可以跳过此步骤直接添加新的文档。

重要提示：

• 第一个框：选择文件类型为 .qch（Qt帮助系统文件格式）。关于如何生成.qch文件，请参考目录解析部分

• 第二个框：导航到Qt安装目录下的文档目录（通常为 Docs/Qt-5.12.12/）

步骤6： 选择所有.qch文件

导航到 Docs/Qt-5.12.12 目录，选择所有的.qch文件：

步骤7： 应用设置

点击右下角的 Apply → OK，完成中文版帮助手册的安装：

验证安装

完成配置后，在代码编辑器中将光标放到任何Qt类的头文件名上，然后按 F1 键，即可看到中文帮助文档。导航栏中的详细描述也已经翻译为中文。

---

💬 结语

希望本项目能够帮助到正在学习Qt的开发者。

说明： 本项目可能会继续更新，也可能不再更新。目前的翻译内容已足够日常学习和开发使用。

---

⚠️ 重要提示

该文档是个人使用AI工具（主要使用 Cursor / 智普AI GLM4.6）进行翻译的，花费了不少时间和精力进行纠正，但仍然可能存在未检查到的错误或疏漏。

开源说明： 目前暂时不打算开源，后续可能会考虑开源。