文件放错目录是运行时路径失效问题，非编译错误；程序可编译通过但执行时报“找不到文件”或崩溃，主因是路径写死、相对路径计算错误或工作目录不一致。
文件放错目录不是编译错误，而是运行时路径失效问题——程序能编译通过，但一执行就报“找不到文件”或直接崩溃。核心在于：C++本身不管理文件位置，它只按你写的路径去查；路径写死、相对路径算错、工作目录不一致，三者任一出错都会触发这个问题。
用 fopen 或 std::ifstream 打不开文件？先确认当前工作目录
很多开发者以为程序从源码目录启动，其实 Visual Studio 默认以“项目目录”（含 .vcxproj 的目录）为工作目录，而命令行运行时则取决于你在哪敲的 cd。一个简单验证方式：
- 在代码开头加
system("cd");（Windows）或system("pwd");（Linux/macOS），运行看输出 - 或用
GetCurrentDirectory（Windows） /getcwd（POSIX）打印实际路径 - 别依赖 IDE 的“启动项目目录”设置，它只影响调试，不影响生成的 exe 双击运行
../ 和 ./ 在不同构建配置下行为不一致
Visual Studio 的 Debug/Release 输出目录不同（Debug/ vs Release/），如果你把资源文件（如 config.txt、image.png）放在 Debug/ 下，Release 版本就会找不到。更隐蔽的是：
- 相对路径是相对于当前工作目录，不是相对于可执行文件目录
- 用
GetModuleFileName+PathRemoveFileSpec（Windows）或readlink("/proc/self/exe", ...)（Linux）才能拿到 exe 所在路径 - Qt 项目常用
QApplication::applicationDirPath()，但纯 C++ 没这层封装，得自己实现
第三方库加载失败（如 OpenCV、SQLite）常因 DLL 路径错乱
不是头文件找不到，而是运行时缺 opencv_world455.dll 这类文件。常见错误现象：
- 程序启动闪退，无任何日志，事件查看器里有“应用程序无法正确初始化”
- 用
Dependency Walker或dumpbin /dependents yourapp.exe查依赖，发现某 DLL 显示 “NOT FOUND” - 即使把 DLL 放进 exe 同目录，仍失败——因为某些库（如 CUDA 相关）会强制检查系统 PATH 或注册表路径
解决办法优先级：① 把所有依赖 DLL 复制到 exe 同目录；② 若不行，把 DLL 所在目录加进 PATH（仅调试用）；③ 真正健壮的做法是用 SetDllDirectory（Windows）在 main 开头指定搜索路径，避免污染全局环境变量。
资源文件硬编码路径导致跨机器失效
写成 "C:\myproject\data\config.json" 看似稳妥，实则最脆弱——换台电脑、换个用户、CI 构建机，路径全崩。真正可行的路径组织逻辑是：
- 所有资源文件统一放在 exe 同级的
resources/子目录下，代码中用std::string res_path = get_exe_dir() + "/resources/config.json"; - 构建时用 CMake 的
configure_file或 MSBuild 的Copy任务，确保资源随 exe 一起部署 - 绝对不要用
GetEnvironmentVariable("USERPROFILE")拼路径——企业环境常禁用用户目录写入权限
最易被忽略的一点：UTF-8 路径在 Windows 上需用 std::filesystem::u8path 或宽字符 API（_wfopen）处理，否则中文路径直接返回空指针，错误码还是 2（文件未找到），根本看不出是编码问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
