C 語言 remove() 返回 -1 失敗？權限、檔案佔用、路徑陷阱完整排查清單

C 語言 remove() 函數返回 -1 表示刪除失敗，且 errno 會被設定。許多開發者確認路徑無誤卻仍失敗，往往忽略了權限、檔案鎖定、工作目錄等隱性因素。本文提供系統性排查清單。

錯誤碼快速對照

#include <stdio.h>
#include <errno.h>
#include <string.h>

if (remove("test.txt") == -1) {
    printf("刪除失敗: %s (errno=%d)\n", strerror(errno), errno);
}

排查步驟（按可能性排序）

1. 檔案被佔用（Windows 高發）

• 檔案在編輯器、IDE、防毒軟體、前一次程式執行未正確關閉 fclose() 中被開啟
• 工具：Resource Monitor → CPU → Associated Handles 搜尋檔名
• 代碼確保：所有 fopen 必配對 fclose，異常路徑也要 fclose

2. 權限不足

• 檔案屬性為「唯讀」 → 右鍵屬性取消勾選
• 目錄需 寫入權限（刪除檔案實質是修改目錄項）
• 以管理員身份執行程式測試

3. 路徑陷阱

• 相對路徑：程式工作目錄非預期（VS 預設在專案目錄，非 Debug/）
• 使用 GetModuleFileName / getcwd 確認實際工作目錄
• 建議用絕對路徑或 _fullpath 轉換

4. 檔案實為目錄

• remove() 只能刪檔案，目錄需用 rmdir() (Windows) / remove() 遞迴 (POSIX)

跨平台刪除封裝範例

int safe_remove(const char *path) {
    struct stat st;
    if (stat(path, &st) != 0) return -1; // 不存在
    
    if (S_ISDIR(st.st_mode)) {
    #ifdef _WIN32
        return _rmdir(path);
    #else
        // 遞迴刪除目錄內容...
        return rmdir(path);
    #endif
    } else {
        return remove(path);
    }
}

調試技巧

1. 執行前用 access(path, W_OK) 檢查寫入權限
2. 失敗時打印 strerror(errno) 而非只看 -1
3. Windows 下可用 _wremove(L"path") 支援 Unicode 路徑

總結

remove() 返回 -1 多半是 檔案被佔用 (EBUSY) 或 權限不足 (EACCES)。務必檢查 errno、確認絕對路徑、以管理員權限測試、確保所有檔案控制代碼已關閉。Windows 開發者特別注意防毒軟體即時掃描造成的短暫鎖定。