判断路径是文件还是目录，很多场景都会遇到：遍历目录、清理缓存、读取配置前做校验。C++17之前通常要写平台相关的系统调用，比如Windows下用GetFileAttributes，Linux下用stat，代码分散且难以移植。从C++17开始，标准库的<filesystem>头文件提供了std::filesystem::is_directory，可以跨平台地完成目录判断。不过它并不是简单地看路径字符串，而是查询文件系统状态，因此路径不存在、符号链接、权限不足等情况下都有特定行为。下面先用一个最小例子展示基本调用。

最基础的调用形式是bool is_directory(const std::filesystem::path& p)，以及带错误码的重载bool is_directory(const std::filesystem::path& p, std::error_code& ec) noexcept。第一个重载在遇到权限不足等系统错误时会抛出std::filesystem::filesystem_error异常；第二个重载不会抛出异常，而是把错误写入ec。如果只是想判断普通目录，推荐使用第一个重载并捕获异常，或者先调用exists确认路径存在。

#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
int main() {
    fs::path p = "C:\\Users\\demo\\test"; // Windows 路径示例
    if (fs::is_directory(p)) {
        std::cout << "是一个目录\n";
    } else {
        std::cout << "不是目录\n";
    }
    return 0;
}

这个例子只回答了“是不是目录”，但如果路径不存在，is_directory也会返回false，和“存在但不是目录”混在一起。实际开发中往往需要更细的区分：不存在、普通文件、目录、符号链接。要做到这一点，就要结合exists、is_regular_file以及symlink_status。

一、is_directory 的函数签名与基本用法

std::filesystem::is_directory有两种重载。第一种接受一个std::filesystem::path参数，内部调用status获取文件状态，如果底层系统调用失败会抛出filesystem_error。第二种额外接受std::error_code引用，标记为noexcept，适合在不能或不想用异常的环境中使用。两者在路径存在且为目录时返回true，其余情况返回false。

这里有一个容易忽略的点：is_directory默认使用status，而status会跟随符号链接。也就是说，如果一个符号链接指向目录，那么is_directory(link_path)会返回true。如果你只想判断链接本身是不是目录类型，应该使用symlink_status或者先判断is_symlink。这一点在清理链接、遍历目录时需要特别小心。

另外，路径是否存在并不会让is_directory单独报错。例如is_directory("C:\\Users\\demo\\not_exist")只是返回false。因此，如果需要区分“目录不存在”和“路径存在但不是目录”，必须在调用前先用exists判断，或者直接使用status结合file_status类型来判断。

二、符号链接、status 与 symlink_status 的区别

符号链接是文件系统里一种特殊文件，它保存的是另一个路径的引用。在C++的std::filesystem中，status(p)会解析该链接，返回链接目标的状态；而symlink_status(p)不会解析，返回链接本身的状态。这个区别直接影响到is_directory的结果。

举个例子：假设D:\\link_dir是一个指向D:\\real_dir的符号链接，而D:\\real_dir是一个真实目录。那么fs::is_directory("D:\\link_dir")返回true，因为跟随链接后指向了目录；而fs::is_symlink(fs::symlink_status("D:\\link_dir"))也会返回true，因为链接本身确实是符号链接。很多路径判断工具会把这类链接单独列为“链接”而不是“目录”，避免后续误删目标内容。

因此，如果你要写一个递归删除目录的函数，建议先判断is_symlink，如果是链接就直接删除链接本身，而不是进入链接指向的目录继续删除。这样可以防止把链接目标下的文件意外清空。

三、结合 exists 与 is_regular_file 写一个健壮的判断函数

单独使用is_directory只能得到二值结果，往往不够用。更常见的需求是把路径分成四类：不存在、普通文件、目录、符号链接。下面这段代码用symlink_status一次性获取状态，再依次判断，避免重复系统调用，也避免异常影响主流程。

#include <iostream>
#include <filesystem>
#include <system_error>
namespace fs = std::filesystem;
enum class PathType {
    NotFound,
    RegularFile,
    Directory,
    Symlink,
    Other
};
PathType get_path_type(const fs::path& p, std::error_code& ec) {
    ec.clear();
    fs::file_status st = fs::symlink_status(p, ec);
    if (ec) {
        return PathType::Other;
    }
    if (!fs::exists(st)) {
        return PathType::NotFound;
    }
    if (fs::is_symlink(st)) {
        return PathType::Symlink;
    }
    if (fs::is_regular_file(st)) {
        return PathType::RegularFile;
    }
    if (fs::is_directory(st)) {
        return PathType::Directory;
    }
    return PathType::Other;
}
int main() {
    fs::path p = "C:\\Users\\demo\\test";
    std::error_code ec;
    PathType t = get_path_type(p, ec);
    if (ec) {
        std::cout << "查询失败: " << ec.message() << "\n";
        return 1;
    }
    switch (t) {
        case PathType::Directory:
            std::cout << "目录\n";
            break;
        case PathType::RegularFile:
            std::cout << "普通文件\n";
            break;
        case PathType::Symlink:
            std::cout << "符号链接\n";
            break;
        case PathType::NotFound:
            std::cout << "路径不存在\n";
            break;
        default:
            std::cout << "其他类型\n";
    }
    return 0;
}

这段代码的关键在于fs::exists(st)接受的是file_status对象，而不是路径。这样可以避免在symlink_status和exists之间路径状态发生变化。对于符号链接，exists(st)同样返回true，但随后用is_symlink把它单独拎出来，不会误判成普通文件或目录。

如果你只关心文件与目录，也可以简化为fs::is_regular_file(p)和fs::is_directory(p)两个判断。但要注意，is_regular_file对符号链接同样会跟随目标，若链接指向普通文件则返回true。所以这种简写只适用于你确实不关心链接类型的场景。

四、错误处理、权限问题与跨平台路径注意

文件系统操作常常受权限影响。在Linux下，用户可能对某个目录没有执行权限，此时调用status或is_directory会抛出filesystem_error。在Windows下，某些受保护的系统目录也会拒绝访问。使用带error_code的重载可以避免异常，但需要检查ec的值，否则可能把“查询失败”错误地当成“不是目录”。

路径写法方面，Windows下传统路径使用反斜杠，例如C:\Users\demo\test。在C++源码的字符串字面量中，反斜杠需要转义，所以写成"C:\\Users\\demo\\test"。如果使用C++11的原始字符串字面量，可以写成R"(C:\Users\demo\test)"，这样更直观，也不会因为漏写转义而出错。Linux和macOS下路径使用正斜杠，例如/home/demo/test，std::filesystem::path会自动处理平台差异。

还有一个细节：std::filesystem::path支持/和\混用，但在Windows上反斜杠是传统分隔符，建议保持风格统一。使用path::preferred_separator可以获取当前平台推荐的分隔符。总体而言，只要使用std::filesystem提供的函数而不是手工拼接路径字符串，就能减少大部分跨平台问题。

综合来看，is_directory是判断目录的核心函数，但它负责的只是“是不是目录”这一个布尔结果。实际工程中更推荐先用symlink_status获取状态，再结合exists、is_symlink、is_regular_file和is_directory做完整分类。这样代码逻辑清晰，也能避免符号链接和权限异常带来的隐性bug。