如何使用C++17 std::filesystem实现移动目录及内容的函数

直接给可落地的实现，你之前调试失败基本都是踩了filesystem的几个常见坑，后面会列具体问题点。
核心实现逻辑：优先用原子性、性能最好的rename接口处理同分区移动，rename失败（典型是跨盘符/跨挂载点场景）自动降级为递归复制+源目录删除，所有路径校验、IO操作只要出错立刻返回false，完全符合错误处理要求。

#include <filesystem>
#include <string_view>
#include <exception>

namespace fs = std::filesystem;

bool MoveFolder(std::string_view oldRelativePath, std::string_view newRelativePath)
{
    try
    {
        // 入参基础校验
        if (oldRelativePath.empty() || newRelativePath.empty())
            return false;

        fs::path sourcePath(oldRelativePath);
        fs::path targetPath(newRelativePath);

        // 源路径必须存在且为目录
        if (!fs::exists(sourcePath) || !fs::is_directory(sourcePath))
            return false;

        // 对齐系统mv命令的目标路径处理逻辑
        if (fs::exists(targetPath))
        {
            if (!fs::is_directory(targetPath))
                return false; // 目标是已存在的普通文件，直接判定失败
            // 目标是已存在目录时，把源目录放到目标目录内部，保留源目录名
            targetPath /= sourcePath.filename();
            if (fs::exists(targetPath))
                return false; // 拼接后的目标路径已存在，避免覆盖直接返回
        }

        std::error_code ec;
        // 优先尝试rename，同分区场景下是原子操作，性能最高
        fs::rename(sourcePath, targetPath, ec);
        if (!ec)
            return true;

        // rename失败（多为跨分区/跨卷场景），走复制+删除的兜底逻辑
        fs::create_directories(targetPath, ec);
        if (ec)
            return false;

        // 递归遍历源目录所有内容
        for (const auto& entry : fs::recursive_directory_iterator(sourcePath, ec))
        {
            if (ec) return false;

            const fs::path& sourceEntry = entry.path();
            // 计算当前条目相对于源根目录的路径，拼接得到目标路径
            fs::path relativePart = fs::relative(sourceEntry, sourcePath, ec);
            if (ec) return false;
            fs::path targetEntry = targetPath / relativePart;

            if (entry.is_directory())
            {
                fs::create_directories(targetEntry, ec);
                if (ec) return false;
            }
            else if (entry.is_regular_file() || entry.is_symlink())
            {
                // 复制文件/符号链接，保留原有属性、链接结构
                fs::copy(sourceEntry, targetEntry,
                    fs::copy_options::copy_symlinks | fs::copy_options::overwrite_existing,
                    ec);
                if (ec) return false;
            }
            else
            {
                // 遇到不支持的特殊文件类型（块设备、管道等）直接返回失败
                return false;
            }
        }

        // 全量复制完成后删除源目录
        fs::remove_all(sourcePath, ec);
        if (ec) return false;

        return true;
    }
    catch (const std::exception&)
    {
        // 兜底捕获所有未预期异常，统一返回false
        return false;
    }
}

常见调试失败原因 #

你之前花一小时没调通，大概率是踩了以下几个高频坑：

• 只调用fs::rename没做降级处理：跨分区/跨卷移动时rename接口会直接报错，这是std::filesystem的设计特性，不是代码语法错误，必须补复制+删除的兜底逻辑
• 没处理目标路径已存在的边界：如果传入的目标路径是已经存在的目录，直接移动会报错，需要和系统mv命令行为对齐，把源文件夹整个放到目标目录下；如果目标路径是已存在的普通文件，要直接返回失败
• 没做错误捕获：filesystem接口默认出错会抛fs::filesystem_error，如果不用带std::error_code参数的重载、也不写try/catch，出错时会直接终止程序，根本走不到返回false的逻辑
• 复制参数配置错误：没开copy_symlinks会把符号链接替换成它指向的实际文件，不符合移动的语义；遍历目录时没用递归迭代器会漏复制子目录内容
• 没提前做路径校验：空路径、源路径不存在、源路径不是文件夹的场景没提前拦截，后续操作必然报错

内容的提问来源于stack exchange，提问作者Doga Oruc