PyQt5 的坑（持续更新）

本文用于记录在使用 PyQt5 过程中踩过的各种坑。

1. 打开文件路径

如果“我的文档”路径被修改过（比如从C:\Users\[UserName]\Documents改为D:\Documents），那么 QFileDialog.getOpenFileName() 将无法直接访问该路径。

doc_dir = QtCore.QStandardPaths.writableLocation(\
              QtCore.QStandardPaths.DocumentsLocation)
print (doc_dir)    # 这里能正确显示

file_path = QtWidgets.QFileDialog.getOpenFileName(None, 
    'Open', doc_dir, 'Text File (*.txt)', 
    options=QtWidgets.QFileDialog.DontUseNativeDialog)[0]

这个例子中，如果没有设置options，那么它打开的将是D:\[UserName]\Documents。

解决办法：不用本地窗口。即上面代码中最后一行的 QFileDialog.DontUseNativeDialog。

---

2. QTabWidget

在 QtDesigner 里面使用自定义的表格（里面含有自定义单元格）并设置了行数，那么自定义单元格无效。

解决办法： _________________。

---

3. 用Pyinstaller打包成exe文件

由于一个未知的原因，当我们用 Pyinstaller 将项目打包成单一 exe 文件后，打开程序时鼠标会显示忙碌状态（虽然资源早已加载完成），过一会才消失。

就是酱紫

解决办法：无。除非打包成文件夹而不是单一 exe 文件，这样就不会出现这种情况。

---

4. 灵异事件

    def __init__(self):
        self.widget_prefixes = {'TEXT': 'txt', 'INTEGER': 'sb', 'BOOLEAN': 'cb'}

    def _widget(self, objname, datatype):
        ''' 根据键名找到对应的控件，不同数据类型对应不同控件 '''
        return self.findChild(QtWidgets.QWidget, self.widget_prefixes[datatype] + objname)

    def setValue(self, obj, typ):
        widget = self._widget(obj, typ)
        if widget:
        # if hasattr(widget, 'setValue'):  # 这两种方法获得的结果截然不同！
            widget.setValue(None)
        else:
            print('Lost type of: %s for widget: %s' % (obj, widget))

---

5. QImage 上的不明噪点

当用 QImage(width, height, format) 或 QImage(QSize, format) 的方法创建透明背景的 QImage 对象时，图片上总有一些花花绿绿的噪点。原因是没仔细看文档：

Warning: This will create a QImage with uninitialized data.

解决办法：这种方法产生的 QImage 是未经初始化的，所以使用之前要用 fill 来打扫一遍，如：img.fill(QColor(0, 0, 0, 0))。

---

6. QWidgetAction 上的输入框不能输入中文

下图中，箭头指的是一个 QMenu 菜单，菜单中有一个 QWidgetAction，上面又加了一个输入框 QLineEdit。这个输入框无法使用 Windows 10 自带的中文输入法输入汉字，只能输入英文字符，或通过 setText() 的方法加入中文字符。

QWidgetAction 示例

而且这个 bug 不是 PyQt 独有的，在 C++ 版的 Qt 中也是如此。

解决办法：显示菜单后，调用它的 activateWindow() 方法，让菜单获得焦点即可。缺点是父窗口会失去焦点，但问题不大。

---

7. 国际化文本无法翻译的现象

QTranslator 的实例不能是本地变量（不能用完即删）。