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 的实例不能是本地变量（不能用完即删）。