在 Linux 系统下使用 Java 创建文件夹，主要通过 java.io.File 类（Java 7 及之前）或 java.nio.file 包（Java 7 及之后，推荐）来实现。

下面我将详细介绍这两种方法，并涵盖常见场景，如创建多级目录、处理权限问题等。

使用 java.io.File (传统方式，适用于所有 Java 版本)

这是最经典和通用的方法，即使在非常老的 Java 版本中也能使用。

创建单级文件夹

使用 File.mkdir() 方法，如果父目录不存在,创建会失败。

import java.io.File;
public class CreateFolderExample {
    public static void main(String[] args) {
        // 定义要创建的文件夹路径
        String folderPath = "/path/to/your/new_folder";
        File folder = new File(folderPath);
        // 检查文件夹是否已存在
        if (!folder.exists()) {
            // 尝试创建文件夹
            boolean isCreated = folder.mkdir();
            if (isCreated) {
                System.out.println("文件夹创建成功: " + folderPath);
            } else {
                System.out.println("文件夹创建失败: " + folderPath);
            }
        } else {
            System.out.println("文件夹已存在: " + folderPath);
        }
    }
}

创建多级文件夹（目录树）

使用 File.mkdirs() 方法，如果路径中的任何父目录不存在，它会一并创建,这是创建目录树最方便的方法。

import java.io.File;
public class CreateMultiFolderExample {
    public static void main(String[] args) {
        // 定义要创建的多级目录路径
        String multiFolderPath = "/path/to/your/parent/child/grandchild";
        File folder = new File(multiFolderPath);
        // 检查文件夹是否已存在
        if (!folder.exists()) {
            // 尝试创建多级目录
            boolean isCreated = folder.mkdirs();
            if (isCreated) {
                System.out.println("多级文件夹创建成功: " + multiFolderPath);
            } else {
                System.out.println("多级文件夹创建失败: " + multiFolderPath);
            }
        } else {
            System.out.println("多级文件夹已存在: " + multiFolderPath);
        }
    }
}

使用 java.nio.file (现代方式，Java 7+ 推荐)

从 Java 7 开始，引入了新的 I/O API (java.nio.file)，它提供了更强大、更灵活的文件操作能力。强烈推荐在 Java 7 及以上版本中使用这种方式。

创建单级文件夹

使用 Files.createDirectory() 方法。如果父目录不存在，它会抛出 NoSuchFileException 异常。

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class CreateFolderNIOExample {
    public static void main(String[] args) {
        // 定义要创建的文件夹路径
        String folderPath = "/path/to/your/new_folder_nio";
        Path path = Paths.get(folderPath);
        try {
            // 检查文件夹是否已存在
            if (!Files.exists(path)) {
                // 创建单级目录，如果父目录不存在会抛出异常
                Path createdPath = Files.createDirectory(path);
                System.out.println("文件夹创建成功: " + createdPath);
            } else {
                System.out.println("文件夹已存在: " + folderPath);
            }
        } catch (IOException e) {
            System.err.println("创建文件夹时发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

创建多级文件夹（目录树）

使用 Files.createDirectories() 方法。如果路径中的任何父目录不存在，它会一并创建，如果目录已存在，它不会抛出异常，而是直接返回。 这个方法非常安全和方便。

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class CreateMultiFolderNIOExample {
    public static void main(String[] args) {
        // 定义要创建的多级目录路径
        String multiFolderPath = "/path/to/your/parent/child/grandchild_nio";
        Path path = Paths.get(multiFolderPath);
        try {
            // 创建多级目录，如果父目录不存在会自动创建
            // 如果目录已存在，此方法不会做任何事，也不会报错
            Path createdPath = Files.createDirectories(path);
            System.out.println("多级文件夹创建成功: " + createdPath);
        } catch (IOException e) {
            System.err.println("创建多级文件夹时发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

重要注意事项和最佳实践

1. 路径分隔符

   • 在 Java 中， (正斜杠) 在 Windows, Linux, macOS 等所有主流操作系统上都能被正确识别为路径分隔符，这是最推荐的做法,因为它具有最好的跨平台性。
   • 避免使用 \ (反斜杠)，因为它在 Java 中是转义字符，需要写成 \\，且仅适用于 Windows。
   • 如果你需要硬编码路径，直接使用 是最简单、最安全的方式。

2. 异常处理

   • 文件操作是 I/O 操作，可能会因为权限不足、磁盘已满、路径无效等多种原因失败。强烈建议将文件操作代码放在 try-catch 块中，以捕获 IOException 或其子类（如 NoSuchFileException）。

3. 检查与创建的原子性

   • if (!file.exists()) { file.mkdirs(); } 这种写法在多线程环境下可能不是原子的，一个线程检查到 exists() 为 false，但在调用 mkdirs() 之前，另一个线程可能已经创建了该目录，在大多数单线程应用或并发要求不高的场景下,这通常不是问题。
   • Files.createDirectories() 方法本身是幂等的，即多次调用对已存在的目录不会有任何副作用，因此它比 File.mkdirs() 更安全。

4. 权限问题

   • 如果你的 Java 进程没有足够的权限在指定路径下创建文件或目录，操作会失败并抛出 AccessDeniedException。
   • 确保运行 Java 程序的用户（tomcat, root 或你自己的普通用户）对目标父目录有写入权限。

总结对比

• 如果你使用 Java 7 或更高版本，请优先使用 Files.createDirectories()，它功能强大、行为安全、代码简洁。
• 如果你需要兼容非常老的 Java 版本（如 Java 6 或更早），则使用 File.mkdirs()。