Windows 11下递归目录迭代器无法显示符号链接子文件夹问题

原因分析 #

1. Windows 11权限模型变更：Win11对普通用户的符号链接操作权限做了更严格的限制，即使代码指定了follow_directory_symlink选项，迭代器也可能因权限不足无法访问符号链接指向的目录，导致被跳过。
2. MSVC标准库实现差异：Visual Studio 2022不同版本的标准库对std::filesystem的符号链接遍历逻辑有调整，部分版本在Win11环境下未正确处理follow_directory_symlink选项。
3. 符号链接属性问题：若符号链接为相对路径、指向不存在的目录，或目标目录本身无访问权限，迭代器会自动跳过，但该情况与Win10正常运行的前提矛盾，优先级较低。

解决方案 #

1. 以管理员权限运行程序 #

右键Visual Studio 2022或编译生成的可执行文件，选择「以管理员身份运行」，测试是否能正常遍历符号链接目录。这是最快验证权限问题的方法。

2. 手动实现递归遍历（绕过标准库迭代器限制） #

放弃依赖recursive_directory_iterator，改用普通directory_iterator手动控制递归逻辑，强制处理符号链接目录：

#include <filesystem>
namespace fs = std::filesystem;

void traverse_directory(const fs::path& target_dir) {
    // 遍历当前目录下所有条目
    for (const auto& entry : fs::directory_iterator(target_dir)) {
        if (fs::is_directory(entry.path())) {
            // 执行你的目录相关操作
            // ...

            // 判断是否为符号链接目录，手动递归进入
            if (fs::is_symlink(entry.path())) {
                try {
                    traverse_directory(entry.path());
                } catch (const fs::filesystem_error& e) {
                    // 处理权限不足或目标不存在等异常
                    // std::cerr << "访问符号链接失败: " << e.what() << std::endl;
                }
            } else {
                // 普通目录递归
                traverse_directory(entry.path());
            }
        }
        // 处理文件逻辑（如果需要）
        // ...
    }
}

int main() {
    traverse_directory("D:\\media\\");
    return 0;
}

3. 更新Visual Studio 2022到最新版本 #

MSVC标准库持续修复std::filesystem的兼容性问题，将VS2022更新至17.8及以上版本，可能已解决Win11下符号链接遍历的bug。

4. 调整系统权限策略（永久解决普通用户权限问题） #

1. 按下Win+R，输入secpol.msc打开「本地安全策略」；
2. 依次展开「本地策略」→「用户权利指派」；
3. 找到「创建符号链接」策略，双击打开；
4. 添加当前用户账户，点击确定后重启电脑，普通用户即可拥有符号链接操作权限。

验证步骤 #

1. 先以管理员身份运行程序，若能正常遍历，说明是权限问题，采用方案3或4解决；
2. 若管理员运行仍无效，尝试手动递归的方案，或更新VS版本排查标准库问题。

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