Windows下路径含空格时QFileDialog.getSaveFileName()报Item Not Found错误

问题现象 #

调用QFileDialog.getSaveFileName()时，当默认路径包含空格（比如示例中的C:/Users/O P），在Windows 10系统下执行以下操作会弹出Item或File Not Found错误提示：

• 在对话框中创建新文件夹并保存文件
• 直接完成保存操作

该问题仅出现在Windows环境，无空格路径或macOS系统下运行正常。

系统环境 #

• PySide 6.5.2
• Python 3.11
• Windows 10 Pro

最小复现代码 #

import sys
from PySide6.QtCore import QStandardPaths
from PySide6.QtWidgets import QFileDialog, QMainWindow, QApplication

default_path = QStandardPaths.writableLocation(QStandardPaths.HomeLocation)
print(repr(default_path))  # 'C:/Users/O P'

app = QApplication(sys.argv)
window = QMainWindow()
window.show()

bundle_path, _ = QFileDialog.getSaveFileName(window, "Create New Bundle",
                                             default_path,
                                             "Bundle (*.deb)")
print(repr(bundle_path))

原因分析 #

这是PySide6在Windows平台下对带空格路径处理的兼容性问题，原生Windows文件对话框对路径的解析逻辑和Qt封装层存在冲突，当路径包含空格时，未正确传递或转义路径参数，导致对话框无法识别有效路径。

解决方案 #

方法1：强制使用Qt自带对话框（推荐） #

通过设置QFileDialog.DontUseNativeDialog选项，绕过Windows原生对话框的路径解析问题：

bundle_path, _ = QFileDialog.getSaveFileName(window, "Create New Bundle",
                                             default_path,
                                             "Bundle (*.deb)",
                                             options=QFileDialog.DontUseNativeDialog)

方法2：手动包裹路径为双引号 #

给带空格的路径添加双引号，确保Windows原生对话框能正确识别：

# 对含空格的路径添加双引号包裹
quoted_default_path = f'"{default_path}"' if ' ' in default_path else default_path
bundle_path, _ = QFileDialog.getSaveFileName(window, "Create New Bundle",
                                             quoted_default_path,
                                             "Bundle (*.deb)")

方法3：升级PySide6版本 #

该路径空格兼容问题在PySide6 6.6.0及以上版本已被官方修复，直接升级到最新稳定版本即可：

pip install --upgrade pyside6

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