| 一、 為什么寫(xiě)這篇東西 自己在使用 BCB5 寫(xiě)一些程序時(shí)需要檢查很多東西，例如內(nèi)存泄漏、資源是否有釋放等等，在使用了很多工具后，發(fā)覺(jué) BCB5 本身自帶的工具—— CodeGuard ，非常不錯(cuò)，使用也挺方便的，但是摸索了很久（以及翻查了一些資料，包括 HELP ）才算是會(huì)用了。寫(xiě)這篇文章的目的希望有這方面的問(wèn)題的朋友可以借鑒一下，大家互相學(xué)習(xí)，共同進(jìn)步。我的聯(lián)系方法： Email ： szbug@szbug.com ，希望志同道合的朋友來(lái)信互相交流。以下這篇文章算是拼湊出來(lái)的一篇文章，一些資料是在書(shū)上找的，一些是在 HELP 上看到了。 二、 什么是 CodeGuard CodeGuard 是在是 C++Builder5 才出現(xiàn)的一個(gè)工具。 CodeGuard 是 C++Builder 中一個(gè)程序在運(yùn)行時(shí)期的檢查器，用于檢查內(nèi)存或者資源的使用，以及函數(shù)調(diào)用的驗(yàn)證。 CodeGuard 可以檢測(cè)到以下的程序運(yùn)行期錯(cuò)誤： l 非法的內(nèi)存釋放。 l 無(wú)效的句柄或者文件流。 l 非法指針。 l 使用已被釋放的指針。 l 內(nèi)存泄漏。 l 分配但最后沒(méi)有釋放的內(nèi)存變量。 l 傳遞給函數(shù)的不正確的參數(shù)（包括 VCL 以及 Win32 函數(shù)）。 l 函數(shù)返回值的錯(cuò)誤。（包括 VCL 以及 Win32 函數(shù)）。 例如：在應(yīng)用程序中試圖多次釋放相同的資源（或者已經(jīng)釋放了的資源）、試圖訪問(wèn)已經(jīng)被釋放的內(nèi)存。 三、 在 BCB5 中怎樣使用 CodeGuard ——配置 CodeGuard 如果要使用 CodeGuard 的話，必須有些代碼編譯進(jìn)你的應(yīng)用程序，所以在改變以下這些設(shè)置后。必須全部重新編譯（切記切記！！！）。第一、打開(kāi)應(yīng)用程序的工程選項(xiàng)的 CodeGuard 頁(yè)框，把 CodeGuard Validation 前面打勾 工程選項(xiàng)里，還有其他三個(gè)選項(xiàng)。第一個(gè)選項(xiàng)允許 CodeGuard 檢查指向局部、全局和靜態(tài)變量的無(wú)效指針和數(shù)據(jù)溢出。第二個(gè)選項(xiàng)允許 CodeGuard 檢測(cè)對(duì)非法的（無(wú)效的、已刪除的）對(duì)象的方法的調(diào)用。第三個(gè)選項(xiàng)允許 CodeGuard 驗(yàn)證內(nèi)嵌指針的訪問(wèn)（在某些資料上說(shuō)，開(kāi)啟這個(gè)選項(xiàng)會(huì)造成程序執(zhí)行速度變得很慢，我測(cè)試過(guò)了，如果工程不是很大的話不是很明顯，可以接受。）一般的調(diào)試是開(kāi)打所有的選項(xiàng)（默認(rèn)選擇也是全部打開(kāi)）。 通過(guò) CodeGuard 的配置工具，可以配置 CodeGuard 的一些選項(xiàng)，在命令行方式執(zhí)行 CGCONFIG.EXE 。可以見(jiàn)到一個(gè)對(duì)話框 Preferences 標(biāo)簽頁(yè)用于設(shè)置 CodeGuard 這個(gè)工具的全局選項(xiàng)。 Enable 選項(xiàng)可以在應(yīng)用程序不重新編譯的情況下使用或者不使用 CodeGuard ，一般來(lái)說(shuō)是都是啟用她。如果使用 CodeGuard 的話，建議設(shè)置工程選項(xiàng)來(lái)禁止或者使用 CodeGuard 。 Stack fill frequency 填充棧頻率是檢測(cè)對(duì)運(yùn)行期棧的無(wú)效訪問(wèn)。 Report 和 Error Message Box 選項(xiàng)是設(shè)置 CodeGuard 報(bào)告錯(cuò)誤的方式。在 Report 里， Stiatistics 選項(xiàng)打開(kāi) CodeGuard 輸出分配和釋放內(nèi)存的統(tǒng)計(jì)表、被使用的 Win32API 的調(diào)用、資源的使用情況，并在日志文件中加上一個(gè)模塊列表，以便檢查錯(cuò)誤。 Resource Leaks 選項(xiàng)是告訴 CodeGuard 在應(yīng)用程序結(jié)束后報(bào)告資源泄漏的情況。選定了 Error Message Box 選項(xiàng)后，當(dāng)應(yīng)用程序不在 IDE 里運(yùn)行時(shí)，如果 CodeGuard 檢測(cè)到錯(cuò)誤信息，那么將采用一個(gè)對(duì)話框的方式告訴使用者。其他選項(xiàng)一般不常用，可以參見(jiàn) C++Builder 的聯(lián)機(jī) HELP 。 CodeGuard 配置工具中的 Resource Options 和 Function Options 頁(yè)框允許用戶(hù)對(duì)應(yīng)用程序的資源、文件和函數(shù)調(diào)用設(shè)置各種跟蹤選項(xiàng)。除非特殊的原因需要改變默認(rèn)的配置，否則使用缺省的設(shè)定就行了。 Function Options 頁(yè)上有一個(gè)比較常用的選項(xiàng)就是記錄一個(gè)特定函數(shù)的每次調(diào)用情況。 Ignored Modules 頁(yè)框允許你告訴 CodeGuard ，當(dāng)檢測(cè)的時(shí)候可以忽略一些運(yùn)行期的錯(cuò)誤（一般是指某些 DLL 或者包）。這個(gè)選項(xiàng)一般不常用。 四、 使用 CodeGuard 使用 CodeGuard 其實(shí)很簡(jiǎn)單，只要像之前那樣配置了 CodeGuard ，然后運(yùn)行你的應(yīng)用程序，無(wú)論你的應(yīng)用程序是否在 IDE 中運(yùn)行， CodeGuard 都將會(huì)按照 CodeGuard 配置的選項(xiàng)監(jiān)視你的應(yīng)用程序。同時(shí)，他還會(huì)向一個(gè)日志文件里輸出所有的信息（文件存放在你的工程所在目錄中，文件名和工程名一樣，擴(kuò)展名為 .cgl ）。例如你的工程名為 C:\Word\Test.prg ，那么 CodeGuard 的日志文件為 C:\Word\Test.cgl ，它是一個(gè)文本文件，可以用任何的文本編輯器來(lái)編輯它。 在 IDE 中，可以通過(guò) < 菜單 >View->Debug Window->CodeGuard Log 來(lái)查看 CodeGuard 的日志文件（或者用快捷鍵 Ctrl+Atl+O ）。 如果你的程序在運(yùn)行是出現(xiàn)屬于 CodeGuard 監(jiān)視的錯(cuò)誤的時(shí)候， CodeGuard 會(huì)把它輸出到 CodeGuard Log 中。并將錯(cuò)誤信息用一顆“樹(shù)”的方式顯示（使用很方便，就像使用 Windows 的資源管理器一樣簡(jiǎn)單）。每個(gè)錯(cuò)誤都可以展開(kāi)，以顯示某種錯(cuò)誤類(lèi)型所特有的一些信息。例如：一個(gè)資源那個(gè)地方使用了、分配以及釋放；發(fā)生錯(cuò)誤時(shí)的棧信息；并且指出了出錯(cuò)的代碼行。這樣就可以很快的找到錯(cuò)誤的根源！ CodeGuard Log 窗口上有兩個(gè)按鈕 Stop 和 Clear 。當(dāng) Stop 選中的時(shí)候，如果這個(gè)時(shí)候程序遇到了錯(cuò)誤， CodeGuard 將停止應(yīng)用程序。如果未選中，那么程序就算遇到了錯(cuò)誤也會(huì)繼續(xù)，這樣可以運(yùn)行一次記錄很多錯(cuò)誤信息。當(dāng) Clear 選中的時(shí)候，應(yīng)用程序每次重新運(yùn)行將清空日志中的信息。 在 CodeGuard Log 窗口中，雙擊單個(gè)錯(cuò)誤的節(jié)點(diǎn)的時(shí)候，如果存在源代碼的話， IDE 窗口會(huì)自動(dòng)跳到那一行代碼上。如果不存在源代碼的話，則顯示 CPU 窗口。圖三中，出現(xiàn)的錯(cuò)誤是資源泄漏。當(dāng)你的鼠標(biāo)雙擊 Tform1 ： Button1Click 這一行的時(shí)候，會(huì)自動(dòng)跳到源代碼中出現(xiàn)錯(cuò)誤的那一行。 當(dāng) CodeGuard 檢測(cè)到一個(gè)錯(cuò)誤的時(shí)候，并找到出現(xiàn)問(wèn)題的源代碼時(shí)，剩下的工作就是如果改正你的代碼。這個(gè)過(guò)程可以配合監(jiān)視和數(shù)據(jù)斷點(diǎn)來(lái)實(shí)現(xiàn)，效果更加好！ 五、 CodeGuard 中的錯(cuò)誤以及原因 CodeGuard 可以檢測(cè)到很多運(yùn)行期的錯(cuò)誤！通常很容易就可以從 CodeGuard 的含義找出錯(cuò)誤的根源。對(duì)于大多數(shù)的錯(cuò)誤， CodeGuard 一般會(huì)顯示的包括：發(fā)生錯(cuò)誤的地方、資源分配、資源釋放、資源被分配以及被訪問(wèn)字節(jié)數(shù)。 1. Access In Freed Memory 如果內(nèi)存被釋放了，在后面還繼續(xù)訪問(wèn)，就會(huì)發(fā)生這個(gè)錯(cuò)誤。在 C/C++ 中，通常使用 new 或者 malloc 分配內(nèi)存，用 delete 和 free 釋放。以下是一個(gè)訪問(wèn)了被釋放的內(nèi)存的例子： void foo() { TMyClass *MyClass = new TMyClass(); delete MyClass; MyClass->xxxx = 10; //MyClass 已經(jīng)被釋放了 } CodeGuard 會(huì)報(bào)告已被釋放的內(nèi)存在何處被訪問(wèn)，內(nèi)存原來(lái)被分配的地方以及內(nèi)存在哪里被釋放的。 2. Method Called On Freed Object 這個(gè)錯(cuò)誤跟前一個(gè)錯(cuò)誤類(lèi)似。起因是由于調(diào)用了已被釋放的對(duì)象的方法而不是訪問(wèn)已被釋放的內(nèi)存！ void foo() { TMyClass *MyClass = new TMyClass(); delete MyClass; MyClass->xxxx (10); } CodeGuard 將顯示在何處調(diào)用了已釋放對(duì)象的方法，對(duì)象被創(chuàng)建的地方以及對(duì)象被釋放的地方。 3. Reference To Freed Resource 在程序中試圖多次（兩次以上）釋放同一個(gè)資源， CodeGuard 將檢測(cè)到這個(gè)錯(cuò)誤，有好幾種方法都會(huì)產(chǎn)生這個(gè)錯(cuò)誤！例如： void foo() { TMyClass *MyClass = new TMyClass(); delete MyClass; delete MyClass; } CodeGuard 將報(bào)告資源在何處第二次被釋放，從而引起這個(gè)錯(cuò)誤的。還會(huì)報(bào)告資源在何處分配，在何處首次釋放。 4. Method Called On Illegally Casted Object 如果在程序中對(duì)有效的內(nèi)存范圍之外的方法的調(diào)用將會(huì)引起這個(gè)錯(cuò)誤。 void foo() { TMyClass *MyClass = new TMyClass[5]; MyClass[5].xxxx(); //No such MyClass[5] delete []MyClass; } CodeGuard 將報(bào)告對(duì)象調(diào)用的方法定義的地方，以及這個(gè)方法被調(diào)用的地方以及對(duì)象或者內(nèi)存被分配地方。 5. Resource Type Mismatch 如果在程序中釋放資源和定義（分配）時(shí)候不一致，會(huì)出現(xiàn)這個(gè)錯(cuò)誤。 void foo() { TMyClass *MyClass = new TMyClass[2]; delete MyClass; //Code1 TMyClass *MyClass = new TMyClass(); delete []MyClass; //Code2 } 在 Code1 以及 Code2 都會(huì)引發(fā) Resource Type Mismatch 錯(cuò)誤， CodeGuard 將會(huì)報(bào)告資源在何處以不一致的方式被釋放，以及資源是在哪里被分配的地方。 6. Access Overrun 當(dāng)訪問(wèn)非法內(nèi)存區(qū)域的內(nèi)存時(shí)會(huì)造成這個(gè)錯(cuò)誤（所訪問(wèn)的內(nèi)存在合法內(nèi)存區(qū)域之后），通常情況下是數(shù)組下標(biāo)引用超出原來(lái)定義的。 void foo() { TMyClass *MyClass = new TMyClass[2]; MyClass[2].abc = 10; //No such MyClass[2] delete [] MyClass; char *ch = new char[5]; strcpy(ch, “123456”); //Error delete []ch; } CodeGuard 報(bào)告出錯(cuò)的地方，資源在哪里分配的。 7. Access Underrun 當(dāng)訪問(wèn)非法內(nèi)存區(qū)域的內(nèi)存時(shí)會(huì)造成這個(gè)錯(cuò)誤（所訪問(wèn)的內(nèi)存在合法內(nèi)存區(qū)域之前）。 void foo() { TMyClass *MyClass = new TMyClass[2]; MyClass[-1].abc = 10; //No such MyClass[2] delete [] MyClass; } CodeGuard 報(bào)告出錯(cuò)的地方，資源在哪里分配的。 8. Uninitialized Stack Accessing 訪問(wèn)棧中為被初始化的區(qū)域?qū)?huì)造成這個(gè)錯(cuò)誤。 void foo1(int **Ptr) { int Var; *Ptr = &Var; } void foo() { int *Ptr; foo1(&Ptr); *Ptr = 100; } CodeGuard 將會(huì)報(bào)告何處訪問(wèn)還沒(méi)有被初始化的棧。 9. Access In Invalid Stack 當(dāng)在程序中嘗試訪問(wèn)棧底部的內(nèi)存的時(shí)候出現(xiàn)這個(gè)錯(cuò)誤！ void foo() { char str[20]; strcpy(&str[-1], “szbug”); } CodeGuard 報(bào)告發(fā)生錯(cuò)誤的地方。 10. Bad Parameter 這個(gè)錯(cuò)誤通常是出現(xiàn)無(wú)效的文件或者其他資源句柄作為參數(shù)傳遞給 VCL 或者 Win32API 函數(shù)時(shí)發(fā)生的。 Void foo() { FILE *Stream; fclose(Stream); } CodeGuard 將報(bào)告使用了不正確參數(shù)的函數(shù)在何處被調(diào)用。 11. Function Failure 這個(gè)錯(cuò)誤是 CodeGuard 在捕獲 VCL 以及 Win32API 函數(shù)的返回值如果出現(xiàn)錯(cuò)誤時(shí)引發(fā)的。 viod foo() { CopyFile(“c:\abc\abc.txt”, “d:\abc\acb.txt”, true); // 如果這個(gè)函數(shù)由于某種原因失敗了， // 那么 CodeGuard 將會(huì)捕獲并報(bào)告 Function Failure 錯(cuò)誤！ } 12. Resource Leak 如果在程序中資源（包括 Winwos 資源，內(nèi)存資源等等），分配了，在程序的最后沒(méi)有釋放！將引發(fā) Resource Leak 錯(cuò)誤。 Void foo() { char *ch = new char[10]; } CodeGuard 將報(bào)告資源創(chuàng)建的地方，以及所泄漏的字節(jié)數(shù)。 六 運(yùn)行后會(huì)生產(chǎn)同名的CGL文件,里面包括函數(shù)的調(diào)用次數(shù)和使用到的DLL.如果有泄露的話,會(huì)指出在來(lái)!!!! Functions called:
delete (35 times)
SysReallocMem (26 times)
SysFreeMem (464 times)
SysGetMem (472 times)
realloc (1 times)
memcpy (1 times)
delete[] (2 times)
free (26 times)
new[] (14 times)
new (40 times)
calloc (5 times)
malloc (20 times)
Resource types used:
object array (14 allocs, 13 max)
object (40 allocs, 28 max)
Modules used:
00400000 02/07/2003 09:56:24 D:\Project1.exe
01190000 02/01/2002 22:00:00 C:\Program
Files\Borland\Delphi7\Bin\BORLNDMM.DLL
0CD00000 02/01/2002 22:00:00 C:\PROGRA~1\Borland\CBUILD~1\Bin\CG32.DLL
10000000 03/09/2001 18:42:32 C:\WINNT\mui\fallback\0404\msctf.dll.mui
32600000 08/20/2002 16:40:24 C:\WINNT\System32\CC3260MT.DLL
37210000 12/28/2002 18:25:22 C:\WINNT\DOWNLO~1\CnsMin.dll
40000000 10/21/2002 06:03:00 C:\WINNT\System32\rtl60.bpl
400B0000 02/01/2002 22:00:00 C:\WINNT\System32\vcl60.bpl
60000000 03/09/2001 17:06:24 C:\WINNT\System32\MSCTF.dll
70BD0000 08/29/2002 09:33:44 C:\WINNT\system32\SHLWAPI.DLL
71710000 08/29/2002 09:33:44 C:\WINNT\system32\comctl32.dll
74FA0000 01/10/2000 20:00:00 C:\WINNT\System32\WS2HELP.DLL
74FB0000 07/22/2002 12:05:04 C:\WINNT\System32\WS2_32.DLL
74FD0000 07/22/2002 12:05:04 C:\WINNT\System32\wsock32.dll
75010000 07/22/2002 12:05:04 C:\WINNT\system32\mpr.dll
75280000 01/10/2000 20:00:00 C:\WINNT\System32\oledlg.dll
75950000 01/10/2000 20:00:00 C:\WINNT\system32\LZ32.DLL
75E00000 07/22/2002 12:05:04 C:\WINNT\System32\IMM32.DLL
76AF0000 07/22/2002 12:05:04 C:\WINNT\system32\comdlg32.dll
777C0000 11/01/2002 16:41:30 C:\WINNT\System32\winspool.drv
777E0000 01/10/2000 20:00:00 C:\WINNT\system32\version.dll
77990000 07/22/2002 12:05:04 C:\WINNT\system32\oleaut32.dll
77A30000 07/22/2002 12:05:04 C:\WINNT\system32\ole32.dll
77D90000 11/11/2002 15:34:36 C:\WINNT\system32\advapi32.dll
77DF0000 11/04/2002 10:59:22 C:\WINNT\system32\user32.dll
77E60000 11/04/2002 10:59:30 C:\WINNT\system32\kernel32.dll
77F40000 07/23/2002 16:34:08 C:\WINNT\system32\GDI32.dll
77F80000 07/22/2002 12:05:04 C:\WINNT\System32\ntdll.dll
78000000 07/22/2002 12:05:04 C:\WINNT\system32\MSVCRT.DLL
786F0000 07/22/2002 12:05:04 C:\WINNT\system32\RPCRT4.dll
78F90000 12/11/2002 17:50:30 C:\WINNT\system32\SHELL32.DLL
==========================================
七、 CodeGuard 還可以檢測(cè)到應(yīng)用程序的很多錯(cuò)誤 ，這里只說(shuō)說(shuō)一些常見(jiàn)的錯(cuò)誤，其他的錯(cuò)誤和例子請(qǐng)參見(jiàn) C++Builder 的 HELP 。希望大家通過(guò) CodeGuard 找出程序中的錯(cuò)誤以及 Bug ！！！希望大家的程序越來(lái)越強(qiáng)壯，越來(lái)越穩(wěn)定。。。呵呵 | 
