Windows C 語言文件操作完整指南：文本/二進制、格式化/隨機讀寫、錯誤處理

Windows 平台 C 語言文件 I/O 系統性掌握

文件操作是系統編程基石。本文基於 MSVC 運行庫，涵蓋文本/二進制模式、格式化讀寫、隨機訪問、錯誤處理、資源管理等核心技能，附帶完整可編譯示例代碼。

一、文件分類與編碼模式

二、fopen 模式字符串完全解析

FILE *fp = fopen("path", "mode");

關鍵：b 表示二進制模式 (Windows 關鍵，禁用 \n↔\r\n 轉換)；+ 表示讀寫雙向。

三、核心 API 分類速查

四、完整示例程序 (cFile.c)

#include "cFile.h"
#include "cHelper.h"  // 假設提供 str_concat2 等輔助

void file_demo1_write_text(const char *root) {
    char *path = str_concat2(root, "\\c_file_demo1.txt");
    FILE *fp = fopen(path, "wt+");  // 文本讀寫，創建/截斷
    if (!fp) { /* errno 處理 */ free(path); return; }

    fputc('w', fp);
    fputs("ebabcd\nwanglei", fp);
    fclose(fp);
    free(path);
}

void file_demo2_read_text(const char *root) {
    char *path = str_concat2(root, "\\c_file_demo1.txt");
    FILE *fp = fopen(path, "rt");
    if (!fp) { free(path); return; }

    char ch;
    while ((ch = fgetc(fp)) != EOF) { /* 處理字符 */ }
    rewind(fp);
    char line[32];
    while (fgets(line, sizeof(line), fp)) { /* 處理行 */ }
    fclose(fp);
    free(path);
}

void file_demo3_formatted(const char *root) {
    char *path = str_concat2(root, "\\c_file_demo2.txt");
    FILE *fp = fopen(path, "wt+");
    if (!fp) { free(path); return; }

    fprintf(fp, "%s %d %d\n", "webabcd", 100, 20);  // 寫入 15 字節
    rewind(fp);
    char name[32]; int num, age;
    fscanf(fp, "%s %d %d\n", name, &num, &age);  // 讀回 3 項
    fclose(fp);
    free(path);
}

void file_demo4_binary(const char *root) {
    struct Employee { int num; char name[32]; };
    struct Employee w[2] = {{100, "wanglei"}, {200, "webabcd"}}, r[2];

    char *path = str_concat2(root, "\\c_file_demo3.b");
    FILE *fp = fopen(path, "wb+");
    if (!fp) { free(path); return; }

    fwrite(w, sizeof(struct Employee), 2, fp);  // 寫入 2 個結構體
    rewind(fp);
    fread(r, sizeof(struct Employee), 2, fp);   // 讀回
    fclose(fp);
    free(path);
}

void file_demo5_random_access(const char *root) {
    struct Employee { int num; char name[32]; };
    struct Employee w[2] = {{100, "wanglei"}, {200, "webabcd"}}, r[1];

    char *path = str_concat2(root, "\\c_file_demo4.b");
    FILE *fp = fopen(path, "wb+");
    if (!fp) { free(path); return; }

    fwrite(w, sizeof(struct Employee), 2, fp);
    fseek(fp, sizeof(struct Employee), SEEK_SET);  // 跳過第1個，定位第2個
    fread(r, sizeof(struct Employee), 1, fp);      // 只讀第2個
    // r[0] = {200, "webabcd"}
    fclose(fp);
    free(path);
}

char *demo_cFile(char *rootPath) {
    file_demo1_write_text(rootPath);
    file_demo2_read_text(rootPath);
    file_demo3_formatted(rootPath);
    file_demo4_binary(rootPath);
    file_demo5_random_access(rootPath);
    return str_concat2("演示文件保存路徑：", rootPath);
}

五、錯誤處理鐵律

1. 每個 fopen 必須檢查 NULL，失敗時讀取 errno (包含 errno.h)。
2. 讀寫後檢查 ferror(fp)，非 0 表示硬件/介質錯誤。
3. 調用 clearerr(fp) 清除標誌後方可繼續操作。
4. 嚴格配對 fclose，即使出錯也要關閉 (或用 goto cleanup 模式)。
5. 二進制模式用 rb/wb，避免 Windows 換行符轉換損壞數據。

六、Windows 特有注意事項

• 路徑分隔符：\\ 或 / (MSVC 支持正斜槓)。
• 大文件 (>2GB)：使用 _fseeki64/_ftelli64 或 fgetpos/fsetpos。
• Unicode 路徑：_wfopen(L"path", L"mode") 配合寬字符。
• 文件共享模式：_fsopen 可指定 _SH_DENYRW 等共享屬性。

掌握文本/二進制模式差異、格式化與塊 I/O 選擇、隨機訪問定位、完整錯誤處理鏈路，是 Windows C 開發者處理持久化數據的基本功。示例代碼涵蓋所有核心場景，可直接作為項目文件模塊基礎。

1. 上一篇文章： Qtun 專案實戰：嵌入 Lua 腳本引擎實現靈活配置與插件擴展
2. 下一篇文章： 深入掌握 C 語言可變參數：stdarg.h 完整指南

關於C語言

多目錄專案 Makefile 寫法實戰：遞迴建構與模組化編譯

專案結構 project/ ├── Makefile

數據結構：C語言實現冒泡排序（Bubble Sort）完整教學

冒泡排序核心思想 冒泡排序通過重複遍歷數組，比較相鄰元素並交

Socket 網絡編程完全指南：地址結構、TCP 流程與服務端/客戶端實現

Socket 網絡編程完全指南：地址結構、TCP 流程與服務

HDU 5444 Elven Postman：二叉搜索樹構建與路徑查詢

HDU 5444 Elven Postman：二叉搜索樹構建