Qt 文件与路径处理笔记

文章目录文件路径是什么特殊目录符号不同系统的路径分隔符Qt 处理路径的四大核心类QFileInfo创建 QFileInfo 对象最常用的信息提取方法特别注意fileName() 对目录的行为QUrl — 统一资源定位符创建 QUrl 的两种正确方式QUrl 与本地文件路径的相互转换判断 QUrl 是否指向本地文件QDir 和 QStandardPathsQDir 常用操作QStandardPaths 获取系统标准路径常见错误与避坑指南常见错误现象及解决方法处理中文路径跨平台路径处理总结文件路径是什么在电脑里每个文件都有一个“地址”叫做路径。绝对路径从磁盘的根目录开始写完整的位置。例WindowsC:/Users/小明/图片/猫.jpg例Linux/Mac/home/小明/图片/猫.jpg相对路径相对于当前工作目录程序正在运行的位置的路径。例图片/猫.jpg假设当前目录是/home/小明特殊目录符号.→ 当前目录..→ 父目录上一级~→ 用户主目录仅 Unix/Linux/macOS 的 Shell 中有效Qt 中不自动识别需用QDir::homePath()不同系统的路径分隔符系统分隔符Windows\反斜杠Linux/macOS/正斜杠跨平台开发的黄金法则在代码中永远使用正斜杠/Qt 会在需要时自动转换为系统原生分隔符。Qt 处理路径的四大核心类类名一句话作用QDir操作目录创建、删除、遍历、路径拼接等QFileInfo获取文件的元信息大小、后缀、修改时间等QUrl统一处理网络地址http://和本地文件file://QStandardPaths获取系统标准文件夹桌面、文档、App数据目录QFileInfoQFileInfo不打开文件只读取文件的属性元数据。使用前需要#include QFileInfo。创建 QFileInfo 对象QFileInfoinfo(/home/user/document.txt);// 直接给路径字符串最常用的信息提取方法假设路径为C:/我的音乐/周杰伦/晴天.mp3方法返回值示例输出fileName()文件名含扩展名晴天.mp3baseName()文件名不含扩展名晴天suffix()扩展名不含点mp3completeSuffix()完整扩展名用于 tar.gz 等情况若为archive.tar.gz→tar.gzpath()文件所在目录不含文件名C:/我的音乐/周杰伦absoluteFilePath()绝对路径C:/我的音乐/周杰伦/晴天.mp3size()文件大小字节3456789lastModified()最后修改时间QDateTime对象isFile()是否是文件true/falseisDir()是否是目录true/falseexists()文件或目录是否存在true/false特别注意fileName() 对目录的行为QFileInfodirInfo(C:/我的音乐/周杰伦);// 这是一个目录qDebug()dirInfo.fileName();// 输出 (空字符串)原因fileName()取的是“最后一个分隔符之后的内容”。对于目录路径Qt 会将其末尾的/忽略掉导致没有内容可返回。因此不要用fileName()获取文件夹名称获取文件夹名称的正确方法QDirdir(C:/我的音乐/周杰伦);QString folderNamedir.dirName();// 周杰伦QUrl — 统一资源定位符QUrl原本是为网址设计的如https://qt.io但它也可以优雅地处理本地文件。很多 Qt 类如QImage、QMediaPlayer、QFileDialog都接受QUrl作为输入因此学会用它很有必要。创建 QUrl 的两种正确方式场景正确写法网络地址QUrl url(https://example.com/pic.jpg);本地文件路径QUrl url QUrl::fromLocalFile(C:/Users/小明/照片.jpg);❌错误示范直接把本地路径字符串传给 QUrl 构造函数QUrlwrong(C:/Users/小明/照片.jpg);// 缺少 file:// 协议Qt 可能会误解✅正确示范QUrl rightQUrl::fromLocalFile(C:/Users/小明/照片.jpg);// right.toString() 会返回 file:///C:/Users/小明/照片.jpgQUrl 与本地文件路径的相互转换转换方向函数本地路径 → QUrlQUrl::fromLocalFile(路径)QUrl → 本地路径.toLocalFile()QString pathD:/doc/readme.txt;QUrl urlQUrl::fromLocalFile(path);qDebug()url.toString();// file:///D:/doc/readme.txtQString originalurl.toLocalFile();qDebug()original;// D:/doc/readme.txt 还原成本地路径判断 QUrl 是否指向本地文件if(url.isLocalFile()){QString filePathurl.toLocalFile();// 接下来可以用 QFileInfo 分析这个文件}QDir 和 QStandardPathsQDir 常用操作#includeQDir// 1. 路径拼接自动处理分隔符QDirdir(C:/Users);QString fulldir.filePath(小明/图片/猫.jpg);// C:/Users/小明/图片/猫.jpg// 2. 创建目录dir.mkdir(新文件夹);// 3. 遍历目录下所有 .txt 文件QStringList filters;filters*.txt;QStringList filesdir.entryList(filters);QStandardPaths 获取系统标准路径#includeQStandardPaths// 获取用户的“文档”文件夹跨平台QString docsQStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);// Windows: C:/Users/用户名/Documents// Linux: /home/用户名/Documents// 获取应用程序专用的数据存储目录强烈推荐存配置文件、数据库等QString appDataQStandardPaths::writableLocation(QStandardPaths::AppLocalDataLocation);// Windows: C:/Users/用户名/AppData/Local/你的程序名// Linux: /home/用户名/.local/share/你的程序名常见错误与避坑指南常见错误现象及解决方法错误现象可能原因解决办法QFileInfo::exists()返回false但文件确实存在用了相对路径而当前工作目录不是你想象的那个打印QDir::currentPath()查看工作目录改用绝对路径或QCoreApplication::applicationDirPath()组合路径想获取文件夹名用了QFileInfo::fileName()得到空字符串fileName()对目录会返回空改用QDir(dirPath).dirName()QUrl::toLocalFile()返回空字符串这个QUrl不是本地文件例如是 http 地址先用isLocalFile()判断直接给QUrl构造函数传本地路径图片/视频无法打开缺少file://协议头使用QUrl::fromLocalFile()在 Windows 下用了反斜杠\Qt 不识别Qt 要求路径中使用正斜杠/使用QDir::fromNativeSeparators()转换或手写/认为QFileInfo能打开并读写文件错误QFileInfo只读元数据不打开文件读写文件用QFile类处理中文路径Qt 内部使用 UTF-8 编码通常能正确处理中文路径。但在 Windows 上如果遇到乱码问题可以尝试QString pathQString::fromLocal8Bit(C:/中文路径/文件.txt);// 或者确保源代码文件保存为 UTF-8 with BOM (Windows)跨平台路径处理总结永远使用正斜杠/写路径Qt 会帮你处理平台差异。使用QStandardPaths获取系统标准目录不要手动拼接路径字符串使用QDirQDir::filePath()进行目录操作和路径拼接需要文件信息 → 用QFileInfo而不是直接操作字符串需要网络/本地统一地址 → 用QUrl。