JAVA重点基础、进阶知识及易错点总结（13）File 类 + 路径操作

Java 巩固进阶 · 第13天主题File 类 路径操作 —— IO 体系的第一块基石 进度概览从今天起我们正式进入Java IO 流体系。第一站java.io.File。 核心价值文件操作基石File是操作文件/目录元数据的唯一入口后续所有流Stream都依赖它定位资源。SpringBoot 实战必备文件上传存储、配置文件加载、日志目录初始化处处可见File的身影。路径兼容性掌握跨平台路径写法避免 “在我机器上能跑上线就报错” 的经典坑。递归思维训练文件遍历是理解递归的最佳场景也是面试高频考点。一、File 类本质它到底能做什么1. 核心定位┌─────────────────────────────────┐ │ File 类 │ ├─────────────────────────────────┤ │ ✅ 表示文件/目录的路径名 │ │ ✅ 操作元数据创建、删除、重命名│ │ ✅ 判断属性是否存在、是文件还是目录│ │ ❌ 不负责读写文件内容 │ │ 读写内容 → 交给 IO 流 │ └─────────────────────────────────┘2. 路径分隔符跨平台第一坑 ⚠️系统分隔符错误示例正确写法Windows\new File(D:\test\a.txt)new File(D:/test/a.txt)Linux/macOS/new File(/home/user/test)✅ 原生支持通用方案File.separator-new File(data File.separator a.txt)最佳实践代码中优先使用/Java 在 Windows 上也能自动识别动态拼接路径时使用File.separator或Paths.get()NIO二、File 构造方法三种姿势推荐一种// ❌ 姿势1直接传完整路径硬编码不灵活Filefile1newFile(D:/workspace/project/data/a.txt);// ✅ 姿势2父路径 子路径最推荐解耦、易维护FiledirnewFile(data);Filefile2newFile(dir,a.txt);// → data/a.txt// ✅ 姿势3字符串数组适合动态拼接多级路径Filefile3newFile(data,sub,a.txt);// → data/sub/a.txt为什么推荐姿势2路径可配置dir可从application.yml读取便于单元测试轻松替换临时目录避免路径拼接错误new File(dir, name)自动处理分隔符三、核心判断方法必背清单 ✅FilefilenewFile(data/a.txt);// 存在性与类型判断file.exists();// [关键] 文件/目录是否存在file.isFile();// 是否是普通文件file.isDirectory();// 是否是目录// 基本信息获取file.getName();// a.txt最后一部分file.getPath();// data/a.txt构造时的路径file.getAbsolutePath();// /Users/xxx/project/data/a.txt完整绝对路径file.length();// 文件大小字节目录返回 0file.lastModified();// 最后修改时间戳毫秒// 转换后续与 NIO 互操作有用file.toURI();// 转为 URIfile.toPath();// 转为 PathJava 7 NIO⚠️高频陷阱FilefilenewFile(a.txt);System.out.println(file.length());// 如果文件不存在返回 0不是异常// ✅ 正确做法先判断 exists() isFile()四、创建 删除安全操作三板斧1. 创建文件注意异常处理FilefilenewFile(data/a.txt);// ✅ 标准写法先判断 捕获异常if(!file.exists()){// 确保父目录存在否则 createNewFile 会静默失败Fileparentfile.getParentFile();if(parent!null!parent.exists()){parent.mkdirs();// 创建父目录}try{booleancreatedfile.createNewFile();// 原子操作线程安全System.out.println(创建成功created);}catch(IOExceptione){e.printStackTrace();// 生产环境建议用日志框架}}2. 创建目录mkdir()vsmkdirs()Filedir1newFile(single);dir1.mkdir();// 仅创建单层父目录不存在则失败Filedir2newFile(a/b/c);dir2.mkdirs();// ✅ 递归创建多级目录推荐永远优先用这个3. 删除操作注意空目录限制// 删除文件file.delete();// 成功返回 true// 删除目录必须是空目录FileemptyDirnewFile(data/empty);emptyDir.delete();// ✅ 成功// ❌ 非空目录直接 delete() 会失败需要递归删除见下方实战任务SpringBoot 实践文件上传时先检查存储目录是否存在不存在则mkdirs()初始化Value(${file.upload-dir})privateStringuploadDir;PostConstructpublicvoidinit(){FiledirnewFile(uploadDir);if(!dir.exists()){dir.mkdirs();// 应用启动时自动创建上传目录}}五、遍历文件夹listFiles()的正确打开方式FiledirnewFile(data);// ⚠️ 关键listFiles() 可能返回 null目录不存在/无权限File[]filesdir.listFiles();if(filesnull){System.err.println(无法访问目录dir.getAbsolutePath());return;}// 遍历打印for(Filef:files){Stringtypef.isDirectory()?[DIR] :[FILE];System.out.println(typef.getName() (f.length() bytes));} 进阶文件名过滤器只查 .txt 文件// 方式1匿名内部类File[]txtFilesdir.listFiles(newFilenameFilter(){Overridepublicbooleanaccept(Filedir,Stringname){returnname.endsWith(.txt);}});// 方式2Lambda 表达式Java 8更简洁File[]txtFilesdir.listFiles((d,name)-name.endsWith(.txt));// 方式3File 过滤器可结合文件属性File[]largeFilesdir.listFiles(file-file.isFile()file.length()1024*1024);六、递归遍历文件扫描的万能钥匙 /** * 递归打印目录下所有文件含子目录 * param dir 起始目录 * param indent 缩进层级用于可视化树形结构 */publicstaticvoidlistAll(Filedir,Stringindent){// 1. 参数校验防御式编程if(dirnull||!dir.exists()||!dir.isDirectory()){return;}// 2. 获取子项注意 null 检查File[]filesdir.listFiles();if(filesnull)return;// 3. 遍历处理for(Filef:files){System.out.println(indent├─ f.getName()(f.isDirectory()?/:)(f.isFile()? (f.length()B):));// 4. 递归如果是目录深入一层if(f.isDirectory()){listAll(f,indent│ );// 缩进增加}}}// 调用示例listAll(newFile(data),);输出效果├─ config/ │ ├─ application.yml (2.1KB) │ └─ logback.xml (1.5KB) ├─ upload/ │ ├─ image.png (3.2MB) │ └─ doc.pdf (1.1MB) └─ readme.md (4.2KB)递归三要素面试必问终止条件!dir.isDirectory()或files null单层逻辑遍历当前目录所有文件/子目录递归调用遇到子目录时调用自身处理七、 今日实战任务文件管理小工具任务1初始化项目目录结构// 要求在当前项目下创建多层目录 data/upload/{image, doc, temp}// 提示使用 mkdirs() 数组遍历String[]subDirs{image,doc,temp};FilebaseDirnewFile(data/upload);// TODO: 补全代码...任务2实现安全删除工具方法/** * 递归删除文件或目录无论是否为空 * param file 要删除的文件/目录 * return 是否全部删除成功 */publicstaticbooleandeleteRecursively(Filefile){// TODO: 实现逻辑// 提示// 1. 如果是目录先递归删除所有子项// 2. 再删除自身// 3. 注意异常处理和返回值}任务3统计目录信息综合练习/** * 统计目录下文件总数、总大小、最大文件 */publicstaticclassDirStat{intfileCount;longtotalSize;FilelargestFile;// TODO: 添加构造方法/getter}publicstaticDirStatanalyzeDir(Filedir){// TODO: 递归遍历 数据统计// 挑战跳过隐藏文件file.isHidden()}任务4结合 SpringBoot 配置# application.ymlapp:upload:base-dir:./uploadsallowed-extensions:[jpg,png,pdf]// 要求读取配置初始化目录并实现文件扩展名过滤的 listFilesValue(${app.upload.allowed-extensions})privateListStringallowedExts;privatebooleanisAllowed(Stringfilename){// TODO: 判断文件名后缀是否在允许列表中忽略大小写} 第13天 · 核心总结File 类定位操作路径/元数据不读写内容所有流FileInputStream 等的入口路径兼容性优先用/或File.separator构造推荐new File(parent, child)安全操作守则创建文件前getParentFile().mkdirs()创建目录永远用mkdirs()遍历目录listFiles()必须判null删除目录非空需递归递归遍历模板背下来if(dirnull||!dir.isDirectory())return;File[]filesdir.listFiles();if(filesnull)return;for(Filef:files){// 处理当前文件if(f.isDirectory())listAll(f,indent );// 递归}SpringBoot 实践点应用启动时初始化上传/日志目录配置文件管理路径避免硬编码文件上传前校验扩展名、大小