使用WinAPI实现文件存在判断时的长路径问题及解决方法

问题描述 #

我用Windows API的GetFileAttributesW()实现了一个替代std::filesystem::exists()的简单函数，追求代码简洁只用到最少的API。但用fs::recursive_directory_iterator()遍历测试时，发现C:\Windows\servicing\LCU\*目录下的所有文件都被判定为不存在，返回错误码ERROR_PATH_NOT_FOUND。该目录是Windows更新缓存目录，以超长文件名著称。

原因分析 #

Windows传统路径解析存在260字符的长度限制（不含终止符），LCU目录下的文件路径长度超过了这个限制，导致GetFileAttributesW()无法正确识别路径。

解决方案 #

在绝对文件路径前添加\\?\\前缀，让Windows启用长路径解析模式，绕过260字符的路径长度限制。这个前缀会告诉Windows API直接使用原生路径解析逻辑，不进行传统的路径规范化处理。

示例超长路径 #

C:\Windows\servicing\LCU\Package_for_RollupFix~31bf3856ad364e35~amd64~~19041.2006.1.7\amd64_microsoft-windows-a..g-whatsnew.appxmain_31bf3856ad364e35_10.0.19041.1741_none_ee5d4a8d060d7653\f\new360videossquare44x44logo.targetsize-16_altform-unplated_contrast-black.png
C:\Windows\servicing\LCU\Package_for_RollupFix~31bf3856ad364e35~amd64~~19041.2006.1.7\amd64_microsoft-windows-a..g-whatsnew.appxmain_31bf3856ad364e35_10.0.19041.1741_none_ee5d4a8d060d7653\f\new360videossquare44x44logo.targetsize-16_altform-unplated_contrast-white.png
C:\Windows\servicing\LCU\Package_for_RollupFix~31bf3856ad364e35~amd64~~19041.2006.1.7\amd64_microsoft-windows-a..g-whatsnew.appxmain_31bf3856ad364e35_10.0.19041.1741_none_ee5d4a8d060d7653\f\new360videossquare44x44logo.targetsize-20_altform-unplated_contrast-black.png
C:\Windows\servicing\LCU\Package_for_RollupFix~31bf3856ad364e35~amd64~~19041.2006.1.7\amd64_microsoft-windows-a..g-whatsnew.appxmain_31bf3856ad364e35_10.0.19041.1741_none_ee5d4a8d060d7653\f\new360videossquare44x44logo.targetsize-20_altform-unplated_contrast-white.png

修改后的实现代码 #

#include <windows.h>

#include <filesystem>
#include <iostream>
#include <string>

using namespace std;
namespace fs = std::filesystem;

// 辅助函数：为绝对路径添加\\?\\前缀
wstring AddLongPathPrefix(const wstring& path) {
    // 检查是否已为长路径格式
    if (path.substr(0, 4) == L"\\\\?\\") {
        return path;
    }
    // 仅处理绝对路径（以盘符开头，如C:\）
    if (path.size() >= 2 && path[1] == L':') {
        return L"\\\\?\\" + path;
    }
    // 相对路径直接返回原路径
    return path;
}

int FileExists(wstring file_path) {
    // 添加长路径前缀
    wstring long_path = AddLongPathPrefix(file_path);

    DWORD attributes = GetFileAttributesW(long_path.c_str());
        
    // 有效属性表示文件存在
    if (attributes != INVALID_FILE_ATTRIBUTES) {
        return true;
    }

    DWORD error_code = GetLastError();
    wcout << error_code << L' ' << file_path << L'\n';

    // 路径相关错误判定为文件不存在
    if (error_code == ERROR_PATH_NOT_FOUND || error_code == ERROR_INVALID_NAME ||
        error_code == ERROR_FILE_NOT_FOUND || error_code == ERROR_BAD_NETPATH)
    {
        return false;
    }

    // 其他错误已输出，返回错误码（如文件被占用等情况）
    return error_code;
}

int main() {
    for (fs::path path : fs::recursive_directory_iterator(L"C:\\", fs::directory_options::skip_permission_denied)) {
        FileExists(path.wstring());
    }

    return 0;
}

注意事项 #

• \\?\\前缀仅对绝对路径有效，相对路径无法通过该前缀启用长路径解析。
• 使用该前缀后，路径中的/不会自动转换为\，也不会处理.和..等相对路径符号，需确保传入的是规范化的绝对路径。
• Windows 10 1607及以上版本可通过组策略或注册表启用全局长路径支持，但添加前缀的方式兼容性更强，适用于所有Windows版本。

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