完備功能的 C 語言文本編輯器開發指南

利用 raylib 建構具有多項先進功能的文本編輯器

精華重點

多重功能實現：涵蓋窗口初始化、文本輸入、光標控制、文件操作及多行文本處理。
進階功能擴展：加入語法高亮、剪下/複製/貼上、搜索替換等功能。
清晰結構與示例代碼：從基礎設置到高級功能，每一部分均提供詳細解釋和範例。

概述與設計思路

開發一個完備功能的文本編輯器在 C 語言中利用 raylib 庫，既考驗程式設計技巧也呈現出對用戶友好的編輯器介面的構想。雖然 raylib 主要針對輕量級遊戲程式設計，但憑藉其靈活的繪圖和輸入事件處理能力，我們可以從零開始建立一個功能強大的文本編輯器。本文將分成多個部分，逐步介紹如何搭建基礎結構、處理文本輸入、多行文本管理以及文件的保存與讀取，最後還會討論如何實現更進階的功能，例如語法高亮、剪貼操作與搜索替換功能。

基礎設置與窗口初始化

環境準備與窗口創建

在開始編寫代碼之前，必須確保系統已安裝 raylib 庫。你可以從 raylib 的官方網站下載預編譯的安裝包，也可透過包管理工具在 Windows 上使用 Visual Studio 或在 Linux 上利用系統的包管理器來安裝。初始化窗口是整個編輯器程序的基礎，使用 raylib 的 InitWindow 函數即可快速創建一個窗口。

窗口初始化範例


/* 
  初始化窗口，定義編輯器視窗的寬度和高度 
*/
#include "raylib.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define MAX_INPUT_CHARS 2048    // 確定文本緩衝區大小
#define FONT_SIZE 20            // 字體大小

int main(void) {
    const int screenWidth = 1024;
    const int screenHeight = 768;
    InitWindow(screenWidth, screenHeight, "完備功能的文本編輯器");
    SetTargetFPS(60);         // 設定幀率上限

    // 設定背景色和字體（字體必須存在於執行目錄或指定路徑）
    Font font = LoadFont("resources/arial.ttf");
    if (font.texture.id == 0) {
        printf("字體載入失敗！請確認 'arial.ttf' 是否存在。\n");
        CloseWindow();
        return -1;
    }

    // 初始化文本緩衝區
    char textBuffer[MAX_INPUT_CHARS] = {0};
    int cursorPosition = 0;   // 用於記錄光標位置
    bool showCursor = true;
    float cursorTimer = 0.0f;

    // 編輯器是否聚焦（是否能進行文字輸入）
    bool textFocused = false;

    // 主循環
    while (!WindowShouldClose()) {
        float deltaTime = GetFrameTime();

        // 檢查鼠標點擊，確保編輯器取得焦點
        if (IsMouseButtonPressed(MOUSE_LEFT_BUTTON)) {
            Rectangle textBox = { 20, 60, screenWidth - 40, screenHeight - 100 };
            if (CheckCollisionPointRec(GetMousePosition(), textBox))
                textFocused = true;
            else 
                textFocused = false;
        }

        //--------------------------------------------------------------------
        // 文本輸入處理
        //--------------------------------------------------------------------
        if (textFocused) {
            // 處理按鍵輸入事件
            int key = GetCharPressed();
            while (key > 0) {
                // 只接受32~126之間的字符，並確保不超過緩衝區大小
                if (key >= 32 && key <= 126 && strlen(textBuffer) < MAX_INPUT_CHARS - 1) {
                    // 如在中間插入字符則移動後續的字元
                    memmove(&textBuffer[cursorPosition + 1], &textBuffer[cursorPosition], strlen(&textBuffer[cursorPosition]) + 1);
                    textBuffer[cursorPosition] = (char)key;
                    cursorPosition++;
                }
                key = GetCharPressed();
            }

            // 處理特殊按鍵：退格鍵處理刪除
            if (IsKeyPressed(KEY_BACKSPACE)) {
                if (cursorPosition > 0) {
                    // 將光標前字元刪除，並移動其後文字
                    cursorPosition--;
                    memmove(&textBuffer[cursorPosition], &textBuffer[cursorPosition + 1], strlen(&textBuffer[cursorPosition + 1]) + 1);
                }
            }

            // 處理方向鍵、Home與End
            if (IsKeyPressed(KEY_LEFT)) {
                if (cursorPosition > 0) cursorPosition--;
            }
            if (IsKeyPressed(KEY_RIGHT)) {
                if (cursorPosition < (int)strlen(textBuffer)) cursorPosition++;
            }
            if (IsKeyPressed(KEY_HOME)) {
                cursorPosition = 0;
            }
            if (IsKeyPressed(KEY_END)) {
                cursorPosition = strlen(textBuffer);
            }

            // 處理換行鍵，如果需要支援多行, 可在此插入'\n'
            if (IsKeyPressed(KEY_ENTER)) {
                if (strlen(textBuffer) < MAX_INPUT_CHARS - 1) {
                    memmove(&textBuffer[cursorPosition + 1], &textBuffer[cursorPosition], strlen(&textBuffer[cursorPosition]) + 1);
                    textBuffer[cursorPosition] = '\n';
                    cursorPosition++;
                }
            }
        }

        //--------------------------------------------------------------------
        // 光標閃爍效果更新
        //--------------------------------------------------------------------
        cursorTimer += deltaTime;
        if (cursorTimer >= 0.5f) {
            showCursor = !showCursor;
            cursorTimer = 0.0f;
        }

        //--------------------------------------------------------------------
        // 文件保存與讀取操作（示例）
        //--------------------------------------------------------------------
        // 按下 CTRL+S 保存文本內容到文件
        if (IsKeyDown(KEY_LEFT_CONTROL) && IsKeyPressed(KEY_S)) {
            FILE *file = fopen("saved_text.txt", "w");
            if (file) {
                fprintf(file, "%s", textBuffer);
                fclose(file);
                printf("文本已成功保存到 saved_text.txt\n");
            }
        }
        // 按下 CTRL+O 打開並讀取文件內容
        if (IsKeyDown(KEY_LEFT_CONTROL) && IsKeyPressed(KEY_O)) {
            FILE *file = fopen("saved_text.txt", "r");
            if (file) {
                fread(textBuffer, sizeof(char), MAX_INPUT_CHARS, file);
                cursorPosition = strlen(textBuffer);
                fclose(file);
                printf("文本已成功讀取自 saved_text.txt\n");
            }
        }

        //--------------------------------------------------------------------
        // 繪圖階段
        //--------------------------------------------------------------------
        BeginDrawing();
        ClearBackground(RAYWHITE);

        // 畫出文本編輯區
        Rectangle textBox = { 20, 60, screenWidth - 40, screenHeight - 100 };
        DrawRectangleRec(textBox, (Color){ 230, 230, 230, 255 });
        DrawRectangleLinesEx(textBox, 2, GRAY);

        // 繪製輸入的文本內容，此處簡單處理單一文本塊與多行文字
        DrawTextEx(font, textBuffer, (Vector2){25, 65}, FONT_SIZE, 2, BLACK);

        // 計算光標位置（這裡簡化為僅用橫向位移，實際多行編輯器需考慮換行）
        int cursorX = 25 + MeasureTextEx(font, textBuffer, FONT_SIZE, 2).x;
        int cursorY = 65;
        if (showCursor && textFocused) {
            DrawLine(cursorX, cursorY, cursorX, cursorY + FONT_SIZE, MAROON);
        }

        // 提示文字：如何使用快捷鍵進行文件操作等
        DrawText("CTRL+S 儲存  |  CTRL+O 開啟文件", 20, screenHeight - 30, 18, DARKGRAY);

        EndDrawing();
    }

    // 釋放資源並結束應用程式
    UnloadFont(font);
    CloseWindow();
    return 0;
}

文本編輯器核心功能詳解

1. 文本輸入與處理

文本輸入功能是整個編輯器的核心。透過 raylib 的 GetCharPressed 函數可以捕捉單次按鍵輸入，並將其加入預先定義的字符緩衝區。當使用者進行編輯時，需實現：

字符插入：當使用者在光標所在位置輸入新字符，該字符會被插入並將後續字符右移。
退格操作：通過 KEY_BACKSPACE 鍵刪除光標前的字符，同時將字符數據左移以填補空白。
光標導航：使用方向鍵（KEY_LEFT、KEY_RIGHT）、Home 與 End 鍵移動光標，確保編輯體驗順暢。
換行處理：支持按下 ENTER 鍵，插入換行符號，從而實現多行文本的編輯。

2. 光標管理與顯示

對於一個文本編輯器來說，光標不僅提供當前編輯位置的視覺提示，還需要通過定時器周期性切換閃爍透明度以達到閃爍效果。這裡我們使用一個變數來追蹤時間，並在達到一定值後反轉光標的顯示狀態。

3. 文件操作：讀取與儲存

文件的保存與讀取對於文本編輯器來說是基本且必須的功能。在本示例中，我們搭配標準 C 語言的文件 I/O 函數，利用 fopen、fread 與 fwrite 實現文本內容的持久保存與加載。使用者可透過按下快捷鍵組合（例如 CTRL+S 或 CTRL+O）觸發相應操作。

4. 多行文本處理

雖然範例中主要演示了單行或者簡單多行文本插入處理，但在實作多行文本編輯器時需考慮文字的換行、自動換行與行號顯示等功能。解決方案包括：

多行字符串管理：將文本存入一個或多個緩衝區中，並用 '\n' 作為行尾標記。
換行計算：通過 MeasureTextEx 來計算文本寬度，當超過編輯區寬度自動分行，使排版整齊。
行號顯示：在文本編輯區左側繪製一列行號，使使用者更便於定位文本內容。

5. 進階功能擴展

為了使編輯器更加實用，考慮增加以下進階功能：

語法高亮：根據編程語言語法規則對文本進行不同顏色的渲染，便於程式碼閱讀和排錯。
剪切、複製、貼上：實現文本選取後，能夠利用剪貼板快速執行文本剪切和粘貼操作。
搜索與替換：添加一個搜索框，幫助使用者快速查找文本中某部分內容，同時支持替換功能以進行批次修改。
多文件窗口支持：允許使用者同時打開多個文本文件，並在不同標籤間切換，提升便捷性。
自動縮排：根據編程語言自動格式化文本，尤其適合開發代碼編輯器。

深度功能範例與使用說明

功能區總覽表

功能模組	說明	實作建議
窗口創建	初始化並配置應用程式窗口	使用 InitWindow、SetTargetFPS
文本輸入	捕捉用戶字符輸入並存入緩衝區	GetCharPressed、memmove 處理字符插入與刪除
光標控制	顯示光標並通過定時器實現閃爍	利用 Timer 更新 showCursor 標誌
文件操作	支持文本的保存與讀取	標準 C 的 fopen、fread、fprintf
語法高亮	根據規則渲染文本不同部分	配合字元分析與顏色渲染繪製
剪貼操作	支持文本剪切、複製與貼上	利用臨時緩衝區與系統剪貼簿接口

實現高級文本功能的關鍵挑戰

對於一個專業等級的編輯器，需要思考的挑戰包括：

記憶體管理：當編輯大文件時，需要高效管理內存，避免頻繁分配與釋放導致的效能瓶頸。可使用動態數據結構儲存文本內容，並設計適合的儲存及編輯策略。
用戶界面更新：保持編輯器界面平滑且不閃爍，需要考慮繪圖優化，如僅重繪變更區域及合理安排刷新策略。
多平台兼容性：依據不同操作系統的字體與文件路徑需做適配，同時兼顧鍵盤事件處理的兼容性。

綜合開發流程與測試

步驟 1：建立基礎結構

從窗口初始化及文本框繪製開始，確保應用初始狀態下能接受用戶輸入。逐步添加文本插入與光標管理功能，並配合文件操作測試保存與讀取。正確性是首要目標，後續功能皆基於一個穩固的基礎架構實現。

步驟 2：擴充多行處理

一旦單行編輯功能完成，接著擴充多行顯示與編輯功能。主要任務包括：

根據換行符分析文本並計算每行顯示長度，確保文字不超出編輯區。
設計行號顯示欄，使使用者能快速定位文本。
考慮編輯操作中行與列的精細控制（例如自動縮排、自動換行）。

步驟 3：加入進階功能

當基本功能穩定後，開始實現語法高亮與剪貼板操作。這意味著需要一個語法分析器，能根據文本內容識別關鍵字，然後根據預設規則對不同部分應用不同顏色。同時，集成剪切、複製與貼上操作有助於滿足日常應用需求。

步驟 4：測試與調試

測試包含單元測試與集成測試，檢查每一模組在獨立環境或協同運作時是否穩定。記錄錯誤日誌並逐步修正，確保在處理大文件時效能不受波動影響。考慮針對不同平台進行測試，保證多平台（如 Windows、Linux 等）能一致執行。

未來改進與社區資源

進一步擴展與持續更新

對於一個文本編輯器來說，功能永遠有擴展的空間。未來可以考慮增加更多的功能模組，例如：編輯歷史記錄、版本控制整合、插件架構以及和其他開源項目的整合。社區資源如 GitHub 上的相關項目，能夠提供大量現成的代碼和思路，亦能幫助迅速解決開發過程中遇到的技術挑戰。

此外，參與 open source 社群，分享並獲取新的實作方法是推動這類編輯器持續進步的重要動力。持續關注 raylib 官方網站與論壇中的更新，也可發現更多先進技術，例如硬體加速文字渲染與自定義 GUI 元件的應用。

結論

本文提供了一個利用 C 語言與 raylib 庫開發完備功能文本編輯器的全面指南。從窗口初始化、文本輸入與光標管理，到文件操作、多行文本處理，同時涵蓋進階功能如語法高亮、剪貼板操作與搜索替換，所有步驟皆依據實際開發經驗與業界最佳實踐。雖然範例代碼僅展示了基礎功能，但透過詳細解析與功能拓展步驟，讀者可進一步對接下來的需求作出完善設計。最終，這種模組化、循序漸進的開發流程不僅有助於創造一個實用且高效的文本編輯器，也為未來更大規模的編輯器開發奠定了堅實基礎。