QFileDialog::getOpenFileName返回QString，空字符串表示取消；需传parent避免模态和定位问题；多选须用实例化dialog并setFileMode；无桌面环境易崩溃，应检测platformName；中文路径需QFile显式指定ReadOnly|Text模式。
QFileDialog::getOpenFileName 用法和常见返回值问题
直接调用 QFileDialog::getOpenFileName 是最常用的方式，但它返回的是 QString，不是文件路径对象——空字符串表示用户点了取消或对话框关闭，QString() 和 "" 都可能，但更可靠的是用 .isEmpty() 判断。
别忘了传入 parent widget 指针（比如 this），否则对话框可能没有模态行为，甚至在多屏环境下位置异常；如果 parent 为 nullptr，对话框仍能弹出，但生命周期和焦点管理容易出问题。
QFileDialog::getOpenFileName(this, "选择配置文件", "/home/user", "JSON Files (*.json);;All Files (*)")- 过滤器字符串中多个类型用两个分号
;;分隔，单个分号;是类型与描述的分隔符 - 第三个参数是默认打开路径，Qt 会尝试记住上次访问目录，但首次启动时依赖这个值
多选文件必须用 exec() + QFileDialog 实例，不能用静态函数
QFileDialog::getOpenFileNames 支持多选，但它返回的是 QStringList，而真正需要多选控制（比如限制扩展名、预设勾选、自定义侧边栏）时，静态函数不够用——得自己 new 一个 QFileDialog 实例，调用 setFileMode(QFileDialog::ExistingFiles)，再 exec()。
注意：exec() 是阻塞调用，但实例必须在堆上创建（new QFileDialog(this)），否则栈对象在函数退出后析构，导致未定义行为；同时记得检查 result() == QDialog::Accepted，而不是只看 selectedFiles() 是否为空。
立即学习“C++免费学习笔记（深入）”；
- 设置多选：
dialog->setFileMode(QFileDialog::ExistingFiles) - 启用名称过滤器：
dialog->setNameFilter("Images (*.png *.jpg *.bmp)") - 获取结果：
const auto files = dialog->selectedFiles()，不是getSelectedFiles()（这个函数不存在）
QFileDialog 在无桌面环境（如 Linux headless）下会崩溃或静默失败
Qt 的 QFileDialog 依赖平台原生对话框实现。在没 X11/Wayland 或没 libgtk-3 的服务器环境里，它可能直接 abort，或者 fallback 到 Qt 自绘界面但样式错乱、按钮不可点。
验证方式很简单：运行时加 -platform offscreen 或设置 QT_QPA_PLATFORM=offscreen，再调用 getOpenFileName —— 大概率 crash 或返回空字符串。生产环境若需支持 CLI 或容器部署，必须提前检测：QGuiApplication::platformName() 是否包含 "xcb"、"wayland" 或 "windows"，否则应禁用文件选择功能，改用命令行参数或配置文件路径硬编码。
- 安全写法：
if (QGuiApplication::platformName().contains("offscreen")) { /* 走降级逻辑 */ } - Qt 6.5+ 可尝试
QFileDialog::DontUseNativeDialog标志强制 Qt 自绘，但部分功能（如 macOS 的标签、Windows 的快速访问）会丢失
中文路径在 Windows 上读取失败，往往不是编码问题而是 QFile 打开方式不对
即使 QFileDialog 正确返回含中文的 QString，后续用 QFile 打开时仍可能失败，错误是 "Permission denied" 或直接返回 false —— 这通常是因为没设置 QFile::Text 或 QFile::ReadOnly 标志，尤其在 Windows 上对 UTF-16 路径支持更敏感。
QFileDialog 返回的 QString 已是 UTF-16（Qt 内部统一），不需要额外转码；但 QFile::open() 必须显式指定模式，否则默认以二进制方式打开，某些中文路径会被系统拒绝。
- 正确打开：
QFile file(path); if (file.open(QFile::ReadOnly | QFile::Text)) { ... } - 避免用
path.toLocal8Bit().constData()转 C 字符串，这在中文路径下极易截断 - 调试时打印
qDebug() 确认是否真含中文，有时看似中文其实是全角 ASCII 符号
Qt 的 QFileDialog 表面简单，但路径语义、平台差异、内存生命周期和编码隐含假设层层嵌套，最容易被忽略的是 parent 指针缺失导致的模态异常，以及 headless 环境下静默失效——这两点不测就上线，第一用户反馈就是“点不动”或“一选就崩”。
