C++使用std::ifstream输入文件流无法读取文件内容该如何排查？

一、触发文件读取报错的常见原因 #

你遇到的报错是std::ifstream打开文件失败，通常由以下几种情况导致：

• 相对路径不匹配：你代码中使用的../data/king-moves.movelist是相对路径，其参考基准是程序运行时的工作目录，而非源代码文件的存储目录。你可以先替换为文件的绝对路径测试，如果能正常打开则说明是路径配置问题，后续再根据你的程序发布目录结构调整相对路径写法即可。
• 权限/文件锁定问题：确认运行程序的账号对目标文件有可读权限，且文件没有被其他进程独占占用。
• 文件名/后缀拼写错误：Linux、macOS等系统下文件名大小写敏感，需要确认代码中写的文件名和实际存储的文件名大小写、后缀完全一致。

二、代码中存在的其他隐藏问题 #

即使文件打开成功，你当前的循环逻辑也存在bug：你先执行读取操作、再判断eof标记，会导致最后一组数据被重复插入。当读取到文件最后一组a和b后，eof标记不会立刻置位，下一轮循环的读取操作会失败，此时a和b还是上一次读取的有效值，会被重复插入到map中后才检测到eof退出。

优化后的代码写法如下：

Engine::Engine() {
    // 可以直接在ifstream构造时指定路径，不用单独调用open
    std::ifstream dbFile("../data/king-moves.movelist");

    // 用is_open()判断打开结果更明确
    if (!dbFile.is_open()) {
        std::cout << "Error: Unable to read king moves" << std::endl;
    } else {
        unsigned long long a, b;
        // 直接把读取操作作为循环条件，读取失败就自动退出
        while (dbFile >> a >> b) {
            m_k_moves_db.insert(std::pair<unsigned long long, unsigned long long>(a, b));
        }
    }
    std::cout << m_k_moves_db.size() << std::endl;
}

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