PyQt5中QFileDialog窗口标题在Mac系统不显示的解决方法咨询

这个问题其实是Qt在macOS上的特性导致的——默认情况下，PyQt5的QFileDialog会调用macOS的原生文件选择器，而macOS的原生对话框本身就没有显示窗口标题的设计，所以你不管是通过getOpenFileName的标题参数，还是手动调用setWindowTitle，都不会看到标题显示。

下面给你两种可行的解决思路，你可以根据自己的需求选择：

思路1：强制使用Qt的非原生对话框 #

如果你的优先级是让标题显示出来，并且保持跨平台的一致性，可以强制Qt使用自己实现的文件对话框，而不是系统原生的。只需要在调用getOpenFileName时加上options=QFileDialog.DontUseNativeDialog参数即可。

修改后的代码示例：

from PyQt5.QtWidgets import QFileDialog, QErrorMessage

# 选择仪器文件：使用非原生对话框，标题正常显示
instrument_file_raw, _ = QFileDialog.getOpenFileName(
    self, 
    "Select Instrument File",
    "",
    "Excel (*.xlsx)",
    options=QFileDialog.DontUseNativeDialog
)
instrument_file_raw = str(instrument_file_raw)
if not instrument_file_raw:
    error_dialog = QErrorMessage(self)
    error_dialog.showMessage('No filename entered')
    return

# 选择运行列表文件同理
run_list_file, _ = QFileDialog.getOpenFileName(
    self, 
    "Select Run List File",
    "",
    "Excel (*.xlsx)",
    options=QFileDialog.DontUseNativeDialog
)
run_list_file = str(run_list_file)
if not run_list_file:
    error_dialog = QErrorMessage(self)
    error_dialog.showMessage('No filename entered')
    return

注意：这种方式的缺点是对话框的样式和macOS原生的不一样，可能会让习惯了系统风格的用户觉得有点违和，但胜在标题能正常显示，逻辑和Windows上一致。

思路2：保留原生对话框，换方式提示用户 #

如果你更想保持macOS的原生体验，那就换一种方式向用户明确提示需要选择的文件类型：

• 在打开文件对话框之前，先用QMessageBox弹出一个提示框，告诉用户接下来要选择什么文件
• 优化文件过滤器的描述，把模糊的Excel (*.xlsx)改成更具体的文字，比如Instrument Excel File (*.xlsx)，让用户在对话框里就能清楚知道要选什么

代码示例：

from PyQt5.QtWidgets import QMessageBox, QFileDialog, QErrorMessage

# 先提示用户要选择仪器文件
QMessageBox.information(self, "Select File", "Please choose the Instrument configuration Excel file (*.xlsx)")
instrument_file_raw, _ = QFileDialog.getOpenFileName(
    self, 
    "",  # 原生对话框不显示标题，留空即可
    "",
    "Instrument Excel File (*.xlsx)"  # 明确的过滤器描述
)
instrument_file_raw = str(instrument_file_raw)
if not instrument_file_raw:
    error_dialog = QErrorMessage(self)
    error_dialog.showMessage('No filename entered')
    return

# 同理提示运行列表文件
QMessageBox.information(self, "Select File", "Please choose the Run List Excel file (*.xlsx)")
run_list_file, _ = QFileDialog.getOpenFileName(
    self, 
    "",
    "",
    "Run List Excel File (*.xlsx)"
)
run_list_file = str(run_list_file)
if not run_list_file:
    error_dialog = QErrorMessage(self)
    error_dialog.showMessage('No filename entered')
    return

这种方式完全贴合macOS的原生体验，用户不会觉得界面突兀，同时也能清晰接收到选择文件的提示。

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