C/C++ 相對路徑打開文件失敗的常見原因與排查清單

現象

源碼與 txt 同目錄，相對路徑 fopen("data.txt", "r") 失敗，絕對路徑也失敗，曾經能打開現在不行。

核心原因排查（按可能性排序）

1. 工作目錄 ≠ 源碼目錄：
   IDE（VS、Code::Blocks、CLion）默認工作目錄為 $(ProjectDir) 或 $(OutDir)（如 Debug/），而非源碼目錄。
   驗證：printf("cwd: %s\n", getcwd(NULL, 0)); 打印當前工作目錄。
2. 文件名大小寫/擴展名隱藏：
   Windows 預設隱藏擴展名，實際文件可能為 data.txt.txt。
   Linux 區分大小寫，Data.txt ≠ data.txt。
3. 文件被獨佔/權限不足：
   文件在別處打開（Excel、記事本）導致獨佔鎖；或無讀取權限。
4. 路徑字符串轉義錯誤：
   Windows 絕對路徑需雙反斜杠 "C:\\data\\file.txt" 或正斜杠 "C:/data/file.txt"。

最佳實踐

// 1. 打印工作目錄確認
char cwd[1024];
getcwd(cwd, sizeof(cwd));
printf("Working dir: %s\n", cwd);

// 2. 用相對可執行文件路徑定位資源
// 獲取模塊路徑 -> 目錄 -> 拼接文件名
char exePath[MAX_PATH];
GetModuleFileNameA(NULL, exePath, MAX_PATH);
PathRemoveFileSpecA(exePath);
strcat(exePath, "\\data.txt");
FILE* fp = fopen(exePath, "r");

IDE 具體設置

• Visual Studio：項目屬性 → Debugging → Working Directory 設為 $(ProjectDir) 或輸出目錄。
• VS Code (launch.json)："cwd": "${workspaceFolder}"。
• CLion：Run/Debug Configuration → Working directory。

確認工作目錄與文件實際位置一致、注意大小寫與擴展名、正確轉義路徑，即可解決相對路徑打不開文件的問題。