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

🚀 Java 巩固进阶 · 第13天

主题：File 类 + 路径操作 —— IO 体系的第一块基石

📅 进度概览：从今天起，我们正式进入Java IO 流体系。第一站：java.io.File。

💡 核心价值：

• 文件操作基石：File是操作文件/目录元数据的唯一入口，后续所有流（Stream）都依赖它定位资源。
• SpringBoot 实战必备：文件上传存储、配置文件加载、日志目录初始化，处处可见File的身影。
• 路径兼容性：掌握跨平台路径写法，避免 “在我机器上能跑，上线就报错” 的经典坑。
• 递归思维训练：文件遍历是理解递归的最佳场景，也是面试高频考点。

一、File 类本质：它到底能做什么？

1. 核心定位

┌─────────────────────────────────┐ │ 📁 File 类 │ ├─────────────────────────────────┤ │ ✅ 表示文件/目录的"路径名" │ │ ✅ 操作元数据：创建、删除、重命名│ │ ✅ 判断属性：是否存在、是文件还是目录│ │ ❌ 不负责读写文件内容！ │ │ （读写内容 → 交给 IO 流） │ └─────────────────────────────────┘

2. 路径分隔符：跨平台第一坑 ⚠️

💡最佳实践：

• 代码中优先使用/，Java 在 Windows 上也能自动识别
• 动态拼接路径时，使用File.separator或Paths.get()（NIO）

二、File 构造方法：三种姿势，推荐一种

// ❌ 姿势1：直接传完整路径（硬编码，不灵活）Filefile1=newFile("D:/workspace/project/data/a.txt");// ✅ 姿势2：父路径 + 子路径（最推荐！解耦、易维护）Filedir=newFile("data");Filefile2=newFile(dir,"a.txt");// → data/a.txt// ✅ 姿势3：字符串数组（适合动态拼接多级路径）Filefile3=newFile("data","sub","a.txt");// → data/sub/a.txt

🔍为什么推荐姿势2？

• 路径可配置：dir可从application.yml读取
• 便于单元测试：轻松替换临时目录
• 避免路径拼接错误：new File(dir, name)自动处理分隔符

三、核心判断方法（必背清单 ✅）

Filefile=newFile("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();// 转为 Path（Java 7+ NIO）

⚠️高频陷阱：

Filefile=newFile("a.txt");System.out.println(file.length());// 如果文件不存在，返回 0！不是异常！// ✅ 正确做法：先判断 exists() && isFile()

四、创建 & 删除：安全操作三板斧

1. 创建文件（注意异常处理）

Filefile=newFile("data/a.txt");// ✅ 标准写法：先判断 + 捕获异常if(!file.exists()){// 确保父目录存在！否则 createNewFile 会静默失败Fileparent=file.getParentFile();if(parent!=null&&!parent.exists()){parent.mkdirs();// 创建父目录}try{booleancreated=file.createNewFile();// 原子操作，线程安全System.out.println("创建成功："+created);}catch(IOExceptione){e.printStackTrace();// 生产环境建议用日志框架}}

2. 创建目录：mkdir()vsmkdirs()

Filedir1=newFile("single");dir1.mkdir();// 仅创建单层，父目录不存在则失败Filedir2=newFile("a/b/c");dir2.mkdirs();// ✅ 递归创建多级目录（推荐！永远优先用这个）

3. 删除操作：注意"空目录"限制

// 删除文件file.delete();// 成功返回 true// 删除目录：必须是空目录！FileemptyDir=newFile("data/empty");emptyDir.delete();// ✅ 成功// ❌ 非空目录直接 delete() 会失败！需要递归删除（见下方实战任务）

💡SpringBoot 实践：
文件上传时，先检查存储目录是否存在，不存在则mkdirs()初始化：

@Value("${file.upload-dir}")privateStringuploadDir;@PostConstructpublicvoidinit(){Filedir=newFile(uploadDir);if(!dir.exists()){dir.mkdirs();// 应用启动时自动创建上传目录}}

五、遍历文件夹：listFiles()的正确打开方式

Filedir=newFile("data");// ⚠️ 关键：listFiles() 可能返回 null！（目录不存在/无权限）File[]files=dir.listFiles();if(files==null){System.err.println("无法访问目录："+dir.getAbsolutePath());return;}// 遍历打印for(Filef:files){Stringtype=f.isDirectory()?"[DIR] ":"[FILE]";System.out.println(type+f.getName()+" ("+f.length()+" bytes)");}

🔥 进阶：文件名过滤器（只查 .txt 文件）

// 方式1：匿名内部类File[]txtFiles=dir.listFiles(newFilenameFilter(){@Overridepublicbooleanaccept(Filedir,Stringname){returnname.endsWith(".txt");}});// 方式2：Lambda 表达式（Java 8+，更简洁）File[]txtFiles=dir.listFiles((d,name)->name.endsWith(".txt"));// 方式3：File 过滤器（可结合文件属性）File[]largeFiles=dir.listFiles(file->file.isFile()&&file.length()>1024*1024);

六、递归遍历：文件扫描的万能钥匙 🔑

/** * 递归打印目录下所有文件（含子目录） * @param dir 起始目录 * @param indent 缩进层级（用于可视化树形结构） */publicstaticvoidlistAll(Filedir,Stringindent){// 1. 参数校验（防御式编程）if(dir==null||!dir.exists()||!dir.isDirectory()){return;}// 2. 获取子项（注意 null 检查！）File[]files=dir.listFiles();if(files==null)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)

💡递归三要素（面试必问）：

1. 终止条件：!dir.isDirectory()或files == null
2. 单层逻辑：遍历当前目录所有文件/子目录
3. 递归调用：遇到子目录时，调用自身处理

七、🎯 今日实战任务：文件管理小工具

任务1：初始化项目目录结构

// 要求：在当前项目下创建多层目录 data/upload/{image, doc, temp}// 提示：使用 mkdirs() + 数组遍历String[]subDirs={"image","doc","temp"};FilebaseDir=newFile("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]

// 要求：读取配置，初始化目录，并实现文件扩展名过滤的 listFiles@Value("${app.upload.allowed-extensions}")privateList<String>allowedExts;privatebooleanisAllowed(Stringfilename){// TODO: 判断文件名后缀是否在允许列表中（忽略大小写）}

📝 第13天 · 核心总结

1. File 类定位：

   • 操作路径/元数据，不读写内容
   • 所有流（FileInputStream 等）的"入口"

2. 路径兼容性：

   • 优先用/或File.separator
   • 构造推荐：new File(parent, child)

3. 安全操作守则：

   • 创建文件前：getParentFile().mkdirs()
   • 创建目录：永远用mkdirs()
   • 遍历目录：listFiles()必须判null
   • 删除目录：非空需递归

4. 递归遍历模板（背下来！）：

   if(dir==null||!dir.isDirectory())return;File[]files=dir.listFiles();if(files==null)return;for(Filef:files){// 处理当前文件if(f.isDirectory())listAll(f,indent+" ");// 递归}

5. SpringBoot 实践点：

   • 应用启动时初始化上传/日志目录
   • 配置文件管理路径，避免硬编码
   • 文件上传前校验扩展名、大小