簡介這是一份用C編寫的記事本程序完整源代碼面向希望從理論走向?qū)嵺`的C初學(xué)者與進階開發(fā)者幫助其理解圖形界面應(yīng)用從設(shè)計到編譯運行的全過程。壓縮包共21個文件約64KB以6個h頭文件、5個cpp源文件為核心輔以ico圖標(biāo)、bmp位圖、rc資源腳本、dsp與dsw工程文件及可執(zhí)行程序覆蓋界面資源、工程配置與業(yè)務(wù)邏輯各層面。項目圍繞主對話框、關(guān)于對話框及文本編輯處理展開涉及MFC或WinAPI窗口創(chuàng)建、消息響應(yīng)、文件讀寫與面向?qū)ο蠓庋b等知識點讀者可借此梳理一個C GUI項目的目錄組織與模塊劃分方式。目前已有482人學(xué)習(xí)下載適合作為課程設(shè)計或自學(xué)練手的參考范例對照源碼調(diào)試運行能更直觀地掌握文本編輯器的實現(xiàn)思路與常見排錯方法。1. 從一份記事本源碼說起為什么我建議你親手跑一遍很多人第一次接觸 C 桌面開發(fā)都是從記事本這類小工具開始的。它看起來簡單但真正拆開一份記事本的 C 源代碼你會發(fā)現(xiàn)里面藏著窗口消息循環(huán)、文本編輯控件、文件讀寫、菜單加速鍵、查找替換、字體設(shè)置這一整套東西。它不像算法題那樣只考一個點而是把 Win32 API 或 Qt 的常用套路串成了一條完整鏈路。這份資源適合兩類人一類是剛學(xué)完 C 語法、想找個能跑起來的完整項目練手的新手另一類是想快速回顧桌面端事件驅(qū)動模型、準(zhǔn)備做二次開發(fā)的老手。下面我就按“能干什么、怎么跑、怎么改”的順序把這份源碼拆開講清楚。2. 項目定位與技術(shù)選型它到底是不是你該下載的那一份2.1 記事本源碼的典型功能邊界一份完整的記事本 C 源代碼通常不會只實現(xiàn)一個能打字的窗口。它至少包含這些功能模塊主窗口與菜單欄、文本編輯區(qū)、文件新建/打開/保存/另存為、撤銷與重做、剪切復(fù)制粘貼、查找與替換、字體與自動換行、狀態(tài)欄行列號顯示。有些版本還會加上最近打開文件列表、打印預(yù)覽、編碼切換。這些功能聽起來基礎(chǔ)但每一個都對應(yīng)著 Win32 或 Qt 里一個具體的 API 調(diào)用或信號槽連接。從項目定位上看它屬于“單文檔界面”應(yīng)用沒有復(fù)雜的多線程和網(wǎng)絡(luò)通信適合用來理解事件驅(qū)動編程的基本骨架。如果你正在找的是那種帶數(shù)據(jù)庫、帶網(wǎng)絡(luò)請求的完整業(yè)務(wù)系統(tǒng)這份源碼可能偏輕但如果你想搞懂一個 Windows 桌面程序從WinMain到消息循環(huán)再到窗口過程函數(shù)的完整生命周期它反而是最干凈的樣本。2.2 技術(shù)棧判斷Win32 API 還是 Qt拿到一份記事本 C 源代碼第一件事是看它依賴什么。常見做法有兩種一種是純 Win32 API 加標(biāo)準(zhǔn) C用CreateWindowEx創(chuàng)建編輯控件用GetOpenFileName調(diào)文件對話框另一種是基于 Qt 的QMainWindow加QTextEdit用信號槽處理菜單動作。兩種路線各有各的適用場景。純 Win32 版本的好處是零第三方依賴一個.cpp加一個.h就能編譯適合理解 Windows 消息機制。缺點是代碼里到處是HWND、WPARAM、LPARAM新手容易看暈。Qt 版本的好處是跨平臺、代碼可讀性高connect一行就能把菜單項和槽函數(shù)綁起來但需要先裝 Qt 開發(fā)環(huán)境。判斷方法很簡單打開源碼目錄看有沒有.pro文件或CMakeLists.txt里出現(xiàn)Qt5::Widgets、Qt6::Widgets。如果有就是 Qt 路線如果只有.vcxproj或Makefile里出現(xiàn)user32.lib、gdi32.lib那就是 Win32 路線。我一般會先看main函數(shù)或WinMain的簽名這是最直接的區(qū)分點。2.3 目錄結(jié)構(gòu)長什么樣一份組織得比較清楚的記事本源碼目錄通常不會太深。常見結(jié)構(gòu)是notepad-cpp/ ├── src/ │ ├── main.cpp # 程序入口WinMain 或 main │ ├── MainWindow.cpp # 主窗口創(chuàng)建與消息處理 │ ├── MainWindow.h │ ├── FileManager.cpp # 文件打開/保存邏輯 │ ├── FileManager.h │ ├── EditOperations.cpp # 查找替換、剪貼板 │ └── resource.rc # 菜單、圖標(biāo)、加速鍵資源 ├── include/ ├── build/ └── README.md這個結(jié)構(gòu)不是固定的但核心思路是把窗口邏輯、文件操作、編輯操作分開。如果你拿到的源碼把所有代碼都塞在一個main.cpp里那說明它更偏向教學(xué)演示改起來會累一些但跑起來反而更簡單?？茨夸浀臅r候重點找resource.rc或.ui文件菜單和快捷鍵的定義基本都在那里。2.4 運行前需要準(zhǔn)備什么Win32 路線的話Windows 上裝 Visual Studio 的“使用 C 的桌面開發(fā)”工作負(fù)載就夠了編譯時鏈接user32.lib、gdi32.lib、comdlg32.lib。如果用的是 MinGW命令行g(shù) main.cpp -o notepad.exe -mwindows -lcomdlg32也能出結(jié)果。Qt 路線則需要先裝 Qt Creator 或命令行 qmake/cmake再配置好對應(yīng)的 Kit。這里有個容易翻車的點有些源碼用了#pragma comment(lib, comctl32.lib)來簡化鏈接但 MinGW 不認(rèn)這個指令換編譯器時要在構(gòu)建腳本里手動補上-lcomctl32。我一般會先看 README 里有沒有寫構(gòu)建命令沒有的話就按“先試 IDE 工程文件再試命令行”的順序來。3. 核心模塊拆解從消息循環(huán)到文件落盤的完整鏈路3.1 程序入口與消息循環(huán)Win32 記事本的骨架就在WinMain里。它做三件事注冊窗口類、創(chuàng)建主窗口、跑消息循環(huán)。下面這段是典型寫法// main.cpp - Win32 記事本入口 int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) { // 1. 注冊窗口類指定窗口過程函數(shù) WndProc WNDCLASSEX wc { sizeof(WNDCLASSEX) }; wc.lpfnWndProc WndProc; // 消息處理回調(diào) wc.hInstance hInstance; wc.lpszClassName LNotepadClass; wc.hCursor LoadCursor(NULL, IDC_IBEAM); wc.hbrBackground (HBRUSH)(COLOR_WINDOW 1); RegisterClassEx(wc); // 2. 創(chuàng)建主窗口編輯控件在 WM_CREATE 里再建 HWND hWnd CreateWindowEx(0, LNotepadClass, L記事本, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, 800, 600, NULL, NULL, hInstance, NULL); ShowWindow(hWnd, nCmdShow); UpdateWindow(hWnd); // 3. 消息循環(huán)從隊列取消息翻譯后分發(fā) MSG msg; while (GetMessage(msg, NULL, 0, 0)) { TranslateMessage(msg); // 處理鍵盤字符消息 DispatchMessage(msg); // 交給 WndProc } return (int)msg.wParam; }這段代碼的關(guān)鍵參數(shù)lpfnWndProc指向窗口過程函數(shù)所有菜單點擊、鍵盤輸入、窗口重繪都會走到那里hCursor設(shè)成IDC_IBEAM是為了讓鼠標(biāo)在編輯區(qū)顯示為文本光標(biāo)hbrBackground用系統(tǒng)窗口色避免自己管理畫刷。消息循環(huán)里的TranslateMessage不能省否則WM_CHAR不會產(chǎn)生編輯框就收不到字符。3.2 窗口過程與編輯控件創(chuàng)建WndProc是消息處理的核心。記事本里最關(guān)鍵的幾條消息是WM_CREATE、WM_COMMAND、WM_SIZE和WM_SETFOCUS。// MainWindow.cpp - 窗口過程函數(shù) LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { static HWND hEdit; // 編輯控件句柄靜態(tài)保存 switch (msg) { case WM_CREATE: // 創(chuàng)建多行編輯控件帶滾動條和自動換行 hEdit CreateWindowEx(WS_EX_CLIENTEDGE, LEDIT, L, WS_CHILD | WS_VISIBLE | WS_VSCROLL | WS_HSCROLL | ES_MULTILINE | ES_AUTOVSCROLL | ES_AUTOHSCROLL, 0, 0, 0, 0, hWnd, (HMENU)ID_EDIT, GetModuleHandle(NULL), NULL); break; case WM_SIZE: // 窗口大小變化時編輯控件鋪滿客戶區(qū) MoveWindow(hEdit, 0, 0, LOWORD(lParam), HIWORD(lParam), TRUE); break; case WM_COMMAND: // 菜單和加速鍵都走這里按 wParam 低字分派 switch (LOWORD(wParam)) { case ID_FILE_NEW: DoFileNew(hWnd, hEdit); break; case ID_FILE_OPEN: DoFileOpen(hWnd, hEdit); break; case ID_FILE_SAVE: DoFileSave(hWnd, hEdit); break; case ID_EDIT_FIND: DoFindReplace(hWnd, hEdit); break; } break; case WM_SETFOCUS: SetFocus(hEdit); // 窗口獲得焦點時把光標(biāo)交給編輯區(qū) break; case WM_DESTROY: PostQuitMessage(0); break; default: return DefWindowProc(hWnd, msg, wParam, lParam); } return 0; }這里有幾個參數(shù)值得注意ES_MULTILINE讓編輯框支持多行ES_AUTOVSCROLL讓內(nèi)容超出時自動滾動WS_EX_CLIENTEDGE加一圈凹陷邊框。WM_SIZE里用LOWORD和HIWORD從lParam取出客戶區(qū)寬高這是 Win32 里傳兩個 16 位值的經(jīng)典做法。WM_COMMAND的LOWORD(wParam)是控件或菜單 IDHIWORD(wParam)是通知碼菜單項一般不用管通知碼。3.3 文件打開與保存對話框和編碼處理文件操作是記事本里最容易出兼容問題的地方。打開文件用GetOpenFileName保存用GetSaveFileName讀寫用CreateFile或標(biāo)準(zhǔn)fopen都行。下面這段用 Win32 通用對話框// FileManager.cpp - 打開文件并讀入編輯框 void DoFileOpen(HWND hWnd, HWND hEdit) { OPENFILENAME ofn { sizeof(OPENFILENAME) }; wchar_t szFile[MAX_PATH] { 0 }; ofn.hwndOwner hWnd; ofn.lpstrFilter L文本文件 (*.txt)\0*.txt\0所有文件 (*.*)\0*.*\0; ofn.lpstrFile szFile; ofn.nMaxFile MAX_PATH; ofn.Flags OFN_FILEMUSTEXIST | OFN_PATHMUSTEXIST; if (!GetOpenFileName(ofn)) return; // 用戶取消 // 以只讀方式打開讀入內(nèi)存 HANDLE hFile CreateFile(szFile, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL); if (hFile INVALID_HANDLE_VALUE) { MessageBox(hWnd, L文件打開失敗, L錯誤, MB_ICONERROR); return; } DWORD dwSize GetFileSize(hFile, NULL); char* pBuf new char[dwSize 1]; DWORD dwRead 0; ReadFile(hFile, pBuf, dwSize, dwRead, NULL); pBuf[dwRead] \0; CloseHandle(hFile); // 轉(zhuǎn)成寬字符后設(shè)置到編輯框 int wlen MultiByteToWideChar(CP_ACP, 0, pBuf, -1, NULL, 0); wchar_t* pWide new wchar_t[wlen]; MultiByteToWideChar(CP_ACP, 0, pBuf, -1, pWide, wlen); SetWindowText(hEdit, pWide); delete[] pBuf; delete[] pWide; }lpstrFilter里的\0分隔和末尾雙\0是 Win32 對話框的固定格式寫錯了過濾器就不顯示。MultiByteToWideChar這里用CP_ACP表示按系統(tǒng)默認(rèn)編碼解析如果源碼要支持 UTF-8就得改成CP_UTF8并且保存時反向用WideCharToMultiByte。我一般會在打開和保存時都加一個編碼判斷避免中文亂碼這個玄學(xué)問題。3.4 查找替換與剪貼板操作查找替換在 Win32 里可以用EM_FINDTEXTEX消息配合FINDTEXTEX結(jié)構(gòu)也可以自己把編輯框內(nèi)容取出來用std::wstring::find做。剪貼板則用OpenClipboard、SetClipboardData、GetClipboardData這一套。下面是一個查找的簡化實現(xiàn)// EditOperations.cpp - 在編輯框中查找文本 bool FindTextInEdit(HWND hEdit, const wchar_t* target, bool matchCase) { if (!target || !*target) return false; // 取編輯框全部內(nèi)容 int len GetWindowTextLength(hEdit); wchar_t* buf new wchar_t[len 1]; GetWindowText(hEdit, buf, len 1); std::wstring content(buf); std::wstring keyword(target); delete[] buf; // 大小寫敏感處理 if (!matchCase) { std::transform(content.begin(), content.end(), content.begin(), towlower); std::transform(keyword.begin(), keyword.end(), keyword.begin(), towlower); } size_t pos content.find(keyword); if (pos std::wstring::npos) return false; // 選中匹配到的文本 SendMessage(hEdit, EM_SETSEL, pos, pos keyword.size()); SendMessage(hEdit, EM_SCROLLCARET, 0, 0); return true; }EM_SETSEL的兩個參數(shù)是起始和結(jié)束字符索引EM_SCROLLCARET讓編輯框滾動到選中位置。這里用std::wstring而不是裸指針是為了避免手動管理內(nèi)存。注意towlower對寬字符逐個轉(zhuǎn)換比std::tolower更適合 Windows 的wchar_t。4. 編譯與運行從源碼到可執(zhí)行文件的完整步驟4.1 Visual Studio 路線如果你拿到的源碼帶.sln或.vcxproj直接雙擊打開確認(rèn)解決方案平臺是 x64 或 Win32然后按 F7 生成。常見問題是字符集設(shè)置項目屬性里“字符集”要選“使用 Unicode 字符集”否則L...寬字符串和CreateWindowEx的寬字符版本會對不上。如果報LNK2019未解析外部符號檢查鏈接器輸入里有沒有comctl32.lib、comdlg32.lib、user32.lib。4.2 MinGW 命令行路線沒有 IDE 工程文件時用命令行編譯更直接# 在源碼目錄下執(zhí)行-mwindows 去掉控制臺窗口 g src/main.cpp src/MainWindow.cpp src/FileManager.cpp \ src/EditOperations.cpp \ -o notepad.exe \ -mwindows -lcomctl32 -lcomdlg32 -lgdi32 -luser32 \ -stdc17-mwindows告訴鏈接器生成 GUI 子系統(tǒng)程序不加的話會彈出一個黑色控制臺窗口。-lcomctl32是通用控件庫-lcomdlg32是通用對話框庫。如果源碼里用了std::filesystemMinGW 版本要夠新否則得加-lstdcfs。4.3 Qt 路線的構(gòu)建方式如果源碼是 Qt 版本看有沒有.pro文件。有的話qmake notepad.pro make # Linux/macOS mingw32-make # Windows MinGW如果是 CMake 工程mkdir build cd build cmake .. -DCMAKE_PREFIX_PATH/path/to/Qt cmake --build .Qt 版本常見問題是找不到Qt5Widgets需要在CMAKE_PREFIX_PATH里指向 Qt 安裝目錄。跑起來后如果界面是空的檢查main.cpp里有沒有QApplication app(argc, argv);和return app.exec();。4.4 運行后的驗證清單程序跑起來后按這個順序驗證新建文件輸入文字看編輯框是否正常響應(yīng)打開一個 UTF-8 的 txt看中文是否亂碼另存為后重新打開看內(nèi)容是否一致按 CtrlZ 看撤銷是否生效拖動窗口邊緣改變大小看編輯區(qū)是否跟著縮放。這幾步能覆蓋消息循環(huán)、文件讀寫、控件布局三條主鏈路。如果某一步失敗基本能定位到對應(yīng)模塊。5. 避坑與常見問題編譯和運行時的血淚記錄5.1 中文亂碼現(xiàn)象、原因與解決現(xiàn)象是打開中文 txt 后顯示成問號或方塊。原因通常是源碼用CP_ACP讀取但文件實際是 UTF-8 編碼或者反過來。解決方法是統(tǒng)一編碼在打開和保存時都用CP_UTF8并在文件開頭寫 BOM 或不寫 BOM 保持一致。我一般會在FileManager里加一個DetectEncoding函數(shù)先讀前三個字節(jié)判斷有沒有 BOM。5.2 鏈接錯誤 LNK2019未解析的外部符號現(xiàn)象是編譯通過但鏈接失敗提示W(wǎng)inMain或CreateWindowExW找不到。原因是字符集不匹配或庫沒鏈接。如果錯誤里帶W后綴說明代碼用了寬字符版本但項目字符集設(shè)成了多字節(jié)。解決是把項目屬性改成“使用 Unicode 字符集”或者在代碼里顯式用CreateWindowExA和char字符串。5.3 編輯框不顯示或無法輸入現(xiàn)象是窗口出來了但編輯區(qū)一片空白打字沒反應(yīng)。原因可能是WM_CREATE里CreateWindowEx返回了 NULL通常是窗口類名寫錯或hInstance傳錯。另一個可能是WM_SETFOCUS沒把焦點交給編輯框。解決是在WM_CREATE后加SetFocus(hEdit)并檢查CreateWindowEx的返回值失敗時用GetLastError看錯誤碼。5.4 菜單點擊沒反應(yīng)現(xiàn)象是菜單能彈出但點了“打開”沒動靜。原因是WM_COMMAND里L(fēng)OWORD(wParam)的 ID 和資源文件里定義的 ID 對不上。解決是打開resource.h或.rc文件核對ID_FILE_OPEN的值確保switch里的 case 和它一致。如果用了加速鍵表還要檢查TranslateAccelerator有沒有在消息循環(huán)里調(diào)用。5.5 程序退出后進程殘留現(xiàn)象是關(guān)閉窗口后任務(wù)管理器里還有進程。原因是WM_DESTROY里漏了PostQuitMessage(0)或者有子線程沒退出。解決是確認(rèn)WM_DESTROY分支存在并且所有CreateThread或std::thread都有對應(yīng)的退出條件。記事本一般沒有多線程這個問題多半是消息循環(huán)寫成了while(1)而不是while(GetMessage(...))。6. 二次開發(fā)改造從記事本到自己的小工具6.1 加一個“最近打開文件”列表改造思路是在FileManager里維護一個std::vectorstd::wstring每次成功打開或保存后把路徑插到最前面去重后保留最近 10 條。菜單里加一個ID_FILE_RECENT子菜單在WM_INITMENUPOPUP里動態(tài)填充。關(guān)鍵代碼是// 在 WM_INITMENUPOPUP 中動態(tài)生成最近文件菜單 case WM_INITMENUPOPUP: { HMENU hMenu (HMENU)wParam; if (GetMenuItemID(hMenu, 0) ID_FILE_RECENT_BASE) { // 清空舊項 while (GetMenuItemCount(hMenu) 0) DeleteMenu(hMenu, 0, MF_BYPOSITION); // 重新填充 for (size_t i 0; i g_recentFiles.size(); i) { AppendMenu(hMenu, MF_STRING, ID_FILE_RECENT_BASE i, g_recentFiles[i].c_str()); } } break; }ID_FILE_RECENT_BASE是一個起始 ID比如 5000每個文件項用5000 i區(qū)分。點擊后在WM_COMMAND里判斷wParam是否落在[5000, 5000 n)區(qū)間取出對應(yīng)路徑再調(diào)用打開邏輯。這個改造能讓你理解動態(tài)菜單和 ID 區(qū)間管理。6.2 換成 Qt 版本需要改什么如果想把 Win32 版本重寫成 Qt核心是把WndProc里的switch拆成一個個槽函數(shù)把CreateWindowEx換成new QTextEdit把GetOpenFileName換成QFileDialog::getOpenFileName。信號槽的連接寫在MainWindow構(gòu)造函數(shù)里// Qt 版本的主窗口構(gòu)造 MainWindow::MainWindow(QWidget* parent) : QMainWindow(parent) { textEdit new QTextEdit(this); setCentralWidget(textEdit); QMenu* fileMenu menuBar()-addMenu(tr(文件)); QAction* openAct fileMenu-addAction(tr(打開)); connect(openAct, QAction::triggered, this, MainWindow::openFile); resize(800, 600); } void MainWindow::openFile() { QString path QFileDialog::getOpenFileName(this, tr(打開文件)); if (path.isEmpty()) return; QFile file(path); if (file.open(QIODevice::ReadOnly | QIODevice::Text)) { textEdit-setPlainText(QString::fromUtf8(file.readAll())); } }Qt 版本的好處是編碼處理簡單QString::fromUtf8直接搞定壞處是打包體積大需要帶 Qt 運行庫。我一般會先用 Win32 版本理解消息機制再用 Qt 版本做實際工具兩者互補。6.3 驗證改造是否成功的三個方法改完之后別急著說“好了”按這三步驗證第一功能回歸把新建、打開、保存、查找、替換、撤銷各走一遍看有沒有改壞第二邊界測試打開一個 10MB 的大文件看會不會卡死或內(nèi)存暴漲第三異常測試打開一個不存在的文件、一個沒有權(quán)限的目錄看錯誤提示是否友好。我習(xí)慣在每次改完FileManager后強制用 UTF-8 和 GBK 兩種編碼各存一次再打開確認(rèn)沒有亂碼才收工。6.4 一個具體技巧用資源文件管理菜單和加速鍵很多新手會把菜單用代碼一行行AppendMenu拼出來改起來很痛苦。更好的做法是在.rc文件里定義菜單和加速鍵表// resource.rc - 菜單和加速鍵定義 IDR_MAINMENU MENU BEGIN POPUP 文件(F) BEGIN MENUITEM 新建(N)\tCtrlN, ID_FILE_NEW MENUITEM 打開(O)...\tCtrlO, ID_FILE_OPEN MENUITEM 保存(S)\tCtrlS, ID_FILE_SAVE MENUITEM SEPARATOR MENUITEM 退出(X), ID_FILE_EXIT END POPUP 編輯(E) BEGIN MENUITEM 撤銷(U)\tCtrlZ, ID_EDIT_UNDO MENUITEM 查找(F)...\tCtrlF, ID_EDIT_FIND END END IDR_MAINACCEL ACCELERATORS BEGIN N, ID_FILE_NEW, VIRTKEY, CONTROL O, ID_FILE_OPEN, VIRTKEY, CONTROL S, ID_FILE_SAVE, VIRTKEY, CONTROL Z, ID_EDIT_UNDO, VIRTKEY, CONTROL F, ID_EDIT_FIND, VIRTKEY, CONTROL END然后在WinMain里用LoadMenu和LoadAccelerators加載消息循環(huán)里加TranslateAccelerator。這樣改快捷鍵不用動 C 代碼只改.rc文件重新編譯就行。從那以后我每次做 Win32 小工具都強制把菜單和加速鍵放進資源文件不再用代碼硬拼——這個習(xí)慣幫我省了很多返工時間。希望幫到你。本文還有配套的精品資源點擊獲取