簡介Delphi開發中第三方VCL組件庫是提升桌面應用界面與交互效率的關鍵。DevExpress VCL作為一套覆蓋網格、下拉聯動、布局容器等常見UI場景的重量級控件集其Full Source版本不僅提供可編譯的完整源碼還支持深入調試與二次定制。在RAD Studio 12.3環境下正確規劃目錄、配置Library路徑、驗證BPL注冊是避免控件丟失和編譯報錯的基礎。通過cxGrid、cxLookupComboBox等核心控件開發者可快速實現數據展示、級聯選擇與自適應布局滿足進銷存、報表平臺及工業上位機等場景需求。本文從版本兼容性、安裝部署流程、常見問題排查到源碼調試技巧系統梳理了DevExpress VCL 23.2.6在實際工程中的落地方法幫助開發者縮短環境搭建時間聚焦業務功能開發。 十幾年前我剛開始用Delphi的時候裝個第三方控件能折騰整整一天組件面板上多出來二十多項就算大豐收。現在拿到DevExpress VCL 23.2.6 Full Source這個包在Delphi 12.3上從解壓到跑通第一個界面半小時內可以搞定。這不是說開發工具變傻瓜了而是這套流程本身就值得整理清楚。DevExpress VCL對Delphi開發者來說算是繞不開的重量級控件庫。不管是做桌面數據庫應用、進銷存系統、報表平臺還是工業上位機界面它幾乎把你要用到的UI控件都包圓了——網格、樹、下拉框、編輯框、圖表、進度條、布局容器、導航面板甚至還有皮膚引擎。這個標題里的Full Source版本意味著你拿到的是一整份可以編譯的VCL組件源碼而不是只有編譯好的運行包。對于做二次開發、追蹤內部實現、甚至自定義控件行為的人來說價值完全不同。這篇文章我把整個內容拆成五個部分來講先搞清楚Full Source包到底包含什么、和普通安裝包有什么區別再走一遍在Delphi 12.3上的完整安裝部署流程然后挑幾個最常用的核心控件做實戰演示接著把我在迭代過程中踩過的常見坑和排查思路整理出來最后分享一些自己的使用心得。適合剛接觸DevExpress VCL的新手也適合準備從舊版本遷移到Delphi 12.3、或者需要全面了解這套組件庫的老手參考。1. 拿到Full Source包之后先搞清楚這幾件事1.1 23.2.6這個版本號到底代表什么先說版本號。23.2.6是DevExpress VCL的發行版本序列它和Delphi自身版本號沒有任何綁定關系。DevExpress每年會發布大版本比如23.1、23.2后面的6是補丁更新的序號23.2.6就是23.2這條產品線上的第六次維護更新。到2024年中的時候23.2.x已經相當穩定了我自己用下來它在Delphi 12系列上的表現比早期版本好很多。這個版本號還對應了一套內部編譯代號主要表現為它在源碼目錄結構里的命名規則。比如你用官方安裝程序裝完之后源碼目錄里會出現類似DXSources這樣的目錄結構不同組件包按VCL套件拆分。你在delphi安裝目錄下的Library路徑配置里添加的也往往是這個源碼目錄而不是只看某一個.dpk文件。這里要特別提醒一下DevExpress VCL和DevExpress FMX是兩套不同的產品標題里寫的是VCL那它只能用在VCL框架下。Delphi 12.3同時支持VCL和FMX兩種應用框架你要是想給FireMonkey移動端或者跨平臺程序用得另外找FMX對應的控件包不能混著來。1.2 Full Source版本和普通安裝包的區別Full Source最直觀的優勢就是你能看到所有控件的源碼。這不是廣告詞是實實在在能落地的能力。普通安裝包比如ExpressDLL或者編譯好的運行時BPL通常只包含.dcu、.bpl、.dpl這些編譯產物你可以在IDE里使用控件但如果運行到某個控件的內部屬性時想搞清楚它為什么會這樣工作會非常痛苦。而Full Source版本里有完整的.dpk工程文件、.pas源碼、.dfm、.res資源還有Demo項目。在IDE里按F7步進調試能直接進入到DevExpress控件的內部方法里去這對排查復雜交互問題幾乎沒有替代價值。我自己印象最深的一次是排查cxGrid在特定數據量下的內存暴漲問題。當時普通模式下只能干瞪眼后來把源碼路徑配置好在DataController的加載循環里打斷點很快就定位到了是某個事件里重復觸發了Bookmark刷新。沒有源碼的話這種問題基本只能靠猜。另外Full Source版本也是做二次定制的基礎。你完全可以在自己的工程里繼承一個TcxGrid后代類或者直接改掉DevExpress某個控件的默認行為然后把工程引用改成指向你的定制版本。這在商業項目中屬于比較敏感的操作但擁有源碼意味著你具備這個能力而不是完全被廠商鎖死。1.3 版本兼容性DevExpress 23.2.6能不能配Delphi 12.3兼容性問題是我拿到包之后第一個要確認的。Delphi 12.3在官方支持列表里DevExpress 23.2.6是明確支持的。怎么確認裝完之后在DevExpress官方文檔的Release Notes里查一下Supported RAD Studio Versions表格就行或者直接看.DPK文件命名比如文件名里帶有D12、DX12的標識一般都能對應上Delphi 12系列。不過要注意如果你本機裝了多個Delphi版本比如Delphi 10.4、11.3、12.3共存安裝DevExpress的時候它會自動檢測到所有IDE版本選擇安裝目標時最好只勾選當前需要的那一個不要一次全勾上。不然多版本混裝容易在Library路徑、BPL注冊表登記上出沖突后面IDE啟動時報一個找不到xxx.bpl的錯誤排查起來挺煩的。我這里把幾個關鍵版本的對應關系整理成了表格DevExpress VCL版本支持的RAD Studio版本關鍵注意點23.2.xRAD Studio 10.4、11.x、12.x覆蓋較長12.3可用22.2.xRAD Studio 10.4、11.x對12.0支持不完整24.1.x更高版本RAD Studio 12.x為主可能放棄部分舊版IDE判斷邏輯很簡單版本越新對老IDE的兼容性越弱但也有例外DevExpress在23.2這條線上一直維護到很靠后的補丁所以在Delphi 12.3上使用23.2.6反而是最穩妥的選擇之一。2. 安裝部署從解壓到IDE里看到控件2.1 目錄規劃和解壓要點拿到DevExpress.VCL.23.2.6.Full.Source.rar之后第一件事情不是雙擊解壓而是先規劃安裝目錄。這個步驟很多人忽視結果后面配置路徑、升級版本的時候到處留垃圾。我個人建議解壓到一個獨立且含版本號標識的目錄比如D:\Components\DevExpress\VCL\23.2.6。這樣做有兩個實際好處第一以后同時維護多個版本時不會互相覆蓋第二IDE的Library路徑里只需要維護一個指向最新版的入口換版本時改路徑比重新清理一堆殘留快得多。路徑本身最好不要有中文也不要放在桌面上。Delphi 12.3對中文路徑的處理比以前好但DevExpress的編譯腳本里有些批處理和資源文件路徑拼接邏輯在非ASCII路徑下偶爾會出現奇怪的問題所以我一直堅持全英文路徑省心。解壓的時候還有一個小細節如果你之前裝過舊版DevExpress務必先卸載干凈或者至少把舊版本的BPL、DCP從IDE的Library路徑里移除。我見過太多人直接覆蓋解壓結果IDE里同時存在兩套版本的運行時包編譯時一會兒用新包一會兒用舊包報錯時完全摸不著頭腦。2.2 用官方安裝程序還是手動編譯Full Source包解壓完之后里面通常自帶一個安裝程序比如DevExpress.VCL.Installer.exe或者一個Build腳本目錄。如果包里有官方安裝程序我強烈建議優先用安裝程序來裝它自動完成編譯、注冊、路徑配置三個步驟幾乎不會出錯。安裝程序會做下面這些事情檢測本機已安裝的RAD Studio版本根據檢測結果選擇對應的.deploy腳本或.reg注冊表配置編譯全部或選定的VCL運行時和設計時包把編譯好的BPL注冊到IDE的組件面板把源碼目錄和編譯輸出目錄寫到IDE的Library搜索路徑里。如果你不想跑安裝程序也可以手動操作流程是用IDE打開源碼目錄下的dxVCL_D12.groupproj注意文件名后綴要和你的Delphi版本匹配右鍵項目組選Build然后逐個安裝。這個方式的靈活度更高但耗時也長全量編譯一次大概十分鐘起步而且需要你對Delphi的包管理機制有一定理解。我個人推薦的做法是第一次安裝用官方安裝程序全部走默認如果中間報錯再去手動編譯對應的包排錯。這樣效率最高。2.3 配置IDE的Library路徑安裝完成后還有一個經常被忽略但至關重要的環節在Delphi 12.3的Tools Options Delphi Compiler Library里確認Library Path已經加入了DevExpress的源碼目錄和輸出目錄。很多人在IDE里能看到控件但一編譯自己的項目就報Unit not found: cxClasses.dcu之類的錯誤問題十有八九出在這里。Library搜索路徑配置不對Delphi找不到DevExpress的.dcu文件自然就無法鏈接。這里有個判斷方法如果你的工程引用了cxGrid打開工程文件.dpr在uses子句里搜一下如果能看到cxGridCustomTableView、cxGridTableView、cxGridDBTableView這些單元名說明源碼路徑被正確引入了。反之IDE會提示找不到單元。補充一下32位和64位編譯目標的輸出目錄是分開的DevExpress安裝程序會分別配置Win32和Win64的路徑。切換平臺時如果發現控件突然丟失先檢查當前平臺的Library配置里有沒有對應的輸出目錄。2.4 驗證安裝是否成功裝完以后不要急著寫代碼先做兩個快速驗證。第一個驗證新建一個VCL Application打開組件面板找到標有DevExpress的選項卡確認cxGrid、cxLookupComboBox、cxButton、dxLayoutControl這些常用組件都有圖標。隨便拖一個cxGrid到窗體上能正常顯示就說明設計時包沒壞。第二個驗證運行一下這個空窗體確認運行時沒有彈“找不到xxx.bpl”的窗口。編譯是通過了但運行類程序時需要加載對應的設計時、運行時BPL如果BPL缺失啟動時會直接報錯而且報錯信息往往比較隱晦。提示如果運行時空窗體報錯找不到cxLibrary.bpl、dxThemeManager.bpl之類的運行時包基本就是Library路徑或者BPL注冊表登記的問題。不要慌張回第2.3節檢查Library路徑然后到IDE的Component Install Packages里確認DevExpress相關的包列表都是勾選狀態。3. 幾個繞不開的核心控件實戰3.1 cxGrid網格控件的三行配置cxGrid是DevExpress VCL里使用率最高的控件沒有之一。它以一個網格容器TcxGrid加上若干層View比如TcxGridDBTableView的形式存在和普通DataSource配合來展示數據。很多人第一次接觸時覺得它層級多、屬性復雜實際上只要抓住幾條主線它就很好用。第一步在窗體上放TcxGrid和一個TDataSourceDataSource連上你的數據集比如TFDQuery、ADOQuery或者ClientDataSet。然后選中cxGrid右鍵選擇Create View選DB Table View生成一個表格視圖。第二步配置TableView和DataSource的關聯procedure TForm1.FormCreate(Sender: TObject); begin cxGrid1DBTableView1.DataController.DataSource : DataSource1; cxGrid1DBTableView1.OptionsView.ColumnAutoWidth : True; cxGrid1DBTableView1.OptionsSelection.MultiSelect : True; end;這里面DataController.DataSource是核心關聯點ColumnAutoWidth讓列寬自動撐滿網格備選項按需開啟即可。第三步通過Columns編輯器添加字段列。右鍵點擊TableView選擇Columns Editor點Add然后綁定DataBinding.FieldName為對應字段名。字段類型、下拉編輯器、排序規則都可以在這里配置。如果你從數據庫查詢數據比如在Delphi里寫一個SELECT語句配合TFDQuery加載訂單數據cxGrid立刻就能顯示出來with FDQuery1 do begin Close; SQL.Text : SELECT * FROM orders WHERE order_date BETWEEN :d1 AND :d2; ParamByName(d1).AsDateTime : Date; ParamByName(d2).AsDateTime : Date 7; Open; end;cxGrid對這類數據集沒有特殊要求只要DataSource有數據它就負責渲染、排序、過濾、分組。代碼量極低回報很高。我踩過的一個小坑默認情況下cxGrid的列會在數據源結構變化時自動恢復默認布局如果你的項目需要記住用戶的列寬和排序方式記得把TableView的OptionsCustomize.ColumnHiding和OptionsCustomize.ColumnsQuickCustomization打開再配合LayoutHelper或者自己存注冊表來實現布局持久化。3.2 cxLookupComboBox下拉聯動cxLookupComboBox是另一個高頻組件它在普通下拉框的基礎上增加了數據綁定能力。常見的場景是選擇某一個分類后另一個下拉框自動顯示該分類下的子項目。核心屬性是Properties.ListSource、Properties.ListFieldNames和Properties.KeyFieldNames。比如我要做一個“先選省份再選城市”的聯動下拉先在窗體上放兩個cxLookupComboBox都指定好各自的ListSource比如qryProvince和qryCity。省份下拉不需要聯動直接綁定即可城市下拉需要在省份的EditValue改變事件里動態過濾數據集procedure TForm1.cxLookupComboBox1PropertiesEditValueChanged(Sender: TObject); begin qryCity.Close; qryCity.SQL.Text : SELECT * FROM city WHERE province_id :pid; qryCity.ParamByName(pid).AsInteger : VarAsType(cxLookupComboBox1.EditValue, varInteger); qryCity.Open; cxLookupComboBox2.Properties.ListSource.DataSet : qryCity; cxLookupComboBox2.Properties.KeyFieldNames : city_id; cxLookupComboBox2.Properties.ListFieldNames : city_name; end;有一個細節要注意EditValue的類型可能是variant直接轉Integer前最好用VarIsNull判斷一下避免未選擇時觸發一次空值過濾把數據集給刷空。這個問題在聯動的第二級、第三級下拉里最常見處理方式就是加一個空值攔截。下拉控件還有一點實用技巧Properties.DropDownListStyle設為lsEditFixedList時用戶只能從列表里選不能自己打字如果允許模糊搜索可以把Properties.IncrementalFiltering打開實時過濾候選列表體驗直接上一個檔次。3.3 布局與間距調整dxLayoutControl的使用DevExpress布局容器在正式項目中幾乎必用。相比裸用Panel和Anchor屬性dxLayoutControl能幫你自動處理子控件之間的間距、對齊方式以及縮放行為尤其適合做單據錄入界面、參數配置界面。比如一個表格布局左邊一列是Label右邊是輸入框放一個TdxLayoutControl到窗體上在控件上右鍵選擇Add Item添加一個LayoutItem把LayoutItem的Caption設為“客戶名稱”再把一個TcxTextEdit拖到這個Item內部讓Item作為容器承載它復制出多行類似Item設置每行Item的AlignHorz為ahClientLayoutControl會自動把控件拉伸到可用寬度。間距調整是另一個高頻需求。很多人在Delphi群里問“子控件間距怎么調”其實在dxLayoutControl里就兩個關鍵屬性OptionsItem.SpacingHorz和OptionsItem.SpacingVert。前者控制水平間距后者控制垂直間距單位都是像素。想讓某一行和其他行拉開距離在對應Item的OptionsItem里單獨改SpacingVert即可。實際項目里我習慣把Container的中間區域都交給LayoutControl只在最外層留一個主Panel負責整體縮放。這樣不管用戶把窗口拉伸到全屏還是縮成一個窄條控件之間都不會互相壓疊或留出大片空白。3.4 圖片顯示與局部放大熱詞里有人搜“picturebox控件局部放大”在數據化管理類軟件里這其實是個很常見的需求商品圖片預覽、圖紙瀏覽、監控截圖回放。DevExpress里對應的是TcxImage基礎用法是設置圖片和縮放模式cxImage1.Properties.Stretch : True; cxImage1.Properties.Proportional : True; cxImage1.Properties.FitMode : ifmFit;Proportional為True時圖片會保持寬高比不會變形FitMode有三個關鍵值ifmFit整體顯示在控件內、ifmStretch拉伸填滿、ifmNoScale按原始大小顯示。我這里推薦默認用ifmFit它既能看全圖又不會變形。局部放大比整體縮放復雜一點我的做法是在鼠標移動事件里實時計算放大區域然后借助一個TForm或者TdxCameraControl之類的輔助元素來顯示細節。如果只是想在同一個控件上畫出放大選框可以用Canvas直接畫矩形procedure TForm1.cxImage1MouseMove(Sender: TObject; Shift: TShiftState; X, Y: Integer); begin cxImage1.Canvas.DrawFocusRect(Rect(X - 30, Y - 30, X 30, Y 30)); end;這只是畫一個矩形框真正的局部放大要在MouseMove里源圖對應區域做二次繪制。一個簡潔方案是源圖保存在一個TBitmap里鼠標移動時用StretchBlt把源圖的對應區域放大到某個TPaintBox上。這套邏輯寫起來不算復雜但需要注意坐標換算特別是控件有縮放、圖片不是原始大小時計算坐標時要拿圖片實際尺寸和顯示尺寸做比例換算。4. 日常開發中最容易踩的坑4.1 控件丟失、IDE里找不到DevExpress選項卡這個問題在熱詞里反復出現現象是每次重新打開Delphi組件面板上的DevExpress選項菜單不在了或者拖到窗體上的控件直接報錯。我遇到過不下十次原因基本可以歸納成三類。第一類BPL版本和IDE版本不匹配。你安裝了針對Delphi 11的DevExpress包然后在Delphi 12.3里打開組件面板注冊表里登記的BPL還是舊版本IDE加載時要么忽略要么直接崩潰。解決辦法是重裝對應版本的安裝包不要手動拷貝BPL。第二類運行時包依賴缺失。DevExpress控件運行依賴若干個基礎運行時包比如cxLibrary.bpl、dxCore.bpl如果這些包缺失或版本舊IDE啟動時也會把整個DevExpress選項卡拿掉。檢查方式是看看Component Install Packages頁面里有沒有條目顯示為“未安裝”或“加載失敗”。第三類路徑配置被清理。新裝了其他第三方控件后某些安裝程序會重寫Library路徑把DevExpress的搜索路徑給擠掉了。處理方式很簡單回第2.3節重新補上即可。4.2 編譯報錯和路徑沖突常見報錯有很多種這里挑三個出現頻率最高的。一是“File not found: cxClasses.dcu”。這是Library路徑沒配上或者路徑里指向了舊版本源碼目錄。檢查當前平臺Win32/Win64的Library路徑是否正確。二是“F2046: File not found: dxBar.dcu”。這個一般是在工程里引用了某個DevExpress單元但該單元對應的源碼目錄不在搜索路徑里。解決辦法是把DevExpress源碼根目錄和Output目錄都加進Library路徑或者把缺失的具體目錄補上。三是“E2201: This implementation file cannot be compiled with the current compiler”。這個在手動編譯源碼包時偶爾出現多半是版本對應關系不對比如用編譯Delphi 12的.dpk文件時IDE里卻切換到Delphi 11的編譯器。熱詞里“delphi 控件版本問題導致每次進入ide都丟失控件需要重新放置”這個場景本質上是設計時包注冊失敗或運行時包加載失敗和上面第一類原因高度重合。我建議把IDE面板里的包檢查一遍確保所有DevExpress相關包都是勾選狀態然后重啟IDE。如果還不行就直接卸載重裝DevExpress比手動修復注冊表快得多。4.3 升級和卸載注意事項DevExpress Full Source的升級路徑比較特殊。從23.2.5升到23.2.6最穩妥的方式是卸載舊版本清理干凈再安裝新版本。不要想著在原目錄上覆蓋解壓因為源碼文件的增減、工程結構的調整都可能導致一個以前編譯過的.dcu文件殘留繼續污染新版本的編譯。卸載時要做的三件事第一在控制面板卸載DevExpress相關程序第二刪除IDE的Library路徑里舊版本的源碼和輸出目錄引用第三檢查Delphi根目錄下的BPL、DCP目錄把名字帶DevExpress或dx開頭的舊文件清掉前提是確認沒有其他工程還在引用舊包。這幾個步驟不能省。我見過有人只是簡單卸載后裝了新版本結果IDE啟動時同時加載了舊版dxBar.bpl和新版cxGrid.dcu編譯期碰運氣運行期直接崩。根源就是卸載不徹底殘留的舊BPL和新版本設計時包沖突。4.4 調試與斷點進入源碼的技巧如果你裝的是Full Source不利用源碼調試能力就太虧了。在Delphi 12.3里進入DevExpress源碼調試需要兩個前提條件。第一個Library路徑里必須包含DevExpress源碼目錄這樣編譯器拿到的是源碼路徑而不是純.dcu地址否則調試器按F7會直接跳出說你沒有這個單元的源碼。第二個禁用對應的運行時包調試優化。在Project Options Runtime Packages里如果你把控件打包為BPL運行時是不會進入源碼的。臨時調試可以取消勾選對應包的Build with runtime packages或者干脆把整個工程改為靜態鏈接模式源碼調試會更流暢。注意靜態鏈接模式下編譯出的exe會變大幾十MB正式發布時一般建議回到運行時包模式減小體積。調試和發布分開處理這個習慣很重要。5. 我的一些使用體會說實話DevExpress VCL這套控件庫的功能量級很大文檔也厚得嚇人。我最初接觸的時候也走過彎路一上來就想把每個控件都摸清楚結果花了很多時間卻什么都沒吃透。后來形成的做法是先掌握cxGrid、cxLookupComboBox、cxButton、dxLayoutControl這幾個主力控件拿它們把常見的業務界面搭出來然后再根據項目需要逐個突破其他高級能力比如圖表、報表、皮膚切換。另外一個很實際的經驗是Full Source版本在調試階段價值巨大但不要輕易去改源碼目錄里的內容。你改掉某個.pas文件后重新Build雖然能通過但這個改動是局部的一旦以后升級版本這個修改就被覆蓋掉了而且你很可能已經忘了自己改過什么。如果確實需要自定義最好繼承一個子類或者在項目代碼里通過事件和屬性級別去實現把改動范圍控制在業務層。當前這個版本我在一個中型進銷存項目里跑了幾個月編譯出的32位程序、64位程序都穩定運行界面加載速度、數據量上萬行的網格操作流暢度都在可接受范圍內。內存泄漏、異常崩潰這類問題沒有出現過。對于希望穩定、可控、界面又想要現代感的桌面應用開發場景Delphi 12.3加DevExpress VCL 23.2.6 Full Source這套組合值得認真考慮。本文還有配套的精品資源點擊獲取 DevExpress VCL 23.2.6 Full Source在Delphi 12.3上的安裝配置與實戰
簡介Delphi開發中第三方VCL組件庫是提升桌面應用界面與交互效率的關鍵。DevExpress VCL作為一套覆蓋網格、下拉聯動、布局容器等常見UI場景的重量級控件集其Full Source版本不僅提供可編譯的完整源碼還支持深入調試與二次定制。在RAD Studio 12.3環境下正確規劃目錄、配置Library路徑、驗證BPL注冊是避免控件丟失和編譯報錯的基礎。通過cxGrid、cxLookupComboBox等核心控件開發者可快速實現數據展示、級聯選擇與自適應布局滿足進銷存、報表平臺及工業上位機等場景需求。本文從版本兼容性、安裝部署流程、常見問題排查到源碼調試技巧系統梳理了DevExpress VCL 23.2.6在實際工程中的落地方法幫助開發者縮短環境搭建時間聚焦業務功能開發。 十幾年前我剛開始用Delphi的時候裝個第三方控件能折騰整整一天組件面板上多出來二十多項就算大豐收。現在拿到DevExpress VCL 23.2.6 Full Source這個包在Delphi 12.3上從解壓到跑通第一個界面半小時內可以搞定。這不是說開發工具變傻瓜了而是這套流程本身就值得整理清楚。DevExpress VCL對Delphi開發者來說算是繞不開的重量級控件庫。不管是做桌面數據庫應用、進銷存系統、報表平臺還是工業上位機界面它幾乎把你要用到的UI控件都包圓了——網格、樹、下拉框、編輯框、圖表、進度條、布局容器、導航面板甚至還有皮膚引擎。這個標題里的Full Source版本意味著你拿到的是一整份可以編譯的VCL組件源碼而不是只有編譯好的運行包。對于做二次開發、追蹤內部實現、甚至自定義控件行為的人來說價值完全不同。這篇文章我把整個內容拆成五個部分來講先搞清楚Full Source包到底包含什么、和普通安裝包有什么區別再走一遍在Delphi 12.3上的完整安裝部署流程然后挑幾個最常用的核心控件做實戰演示接著把我在迭代過程中踩過的常見坑和排查思路整理出來最后分享一些自己的使用心得。適合剛接觸DevExpress VCL的新手也適合準備從舊版本遷移到Delphi 12.3、或者需要全面了解這套組件庫的老手參考。1. 拿到Full Source包之后先搞清楚這幾件事1.1 23.2.6這個版本號到底代表什么先說版本號。23.2.6是DevExpress VCL的發行版本序列它和Delphi自身版本號沒有任何綁定關系。DevExpress每年會發布大版本比如23.1、23.2后面的6是補丁更新的序號23.2.6就是23.2這條產品線上的第六次維護更新。到2024年中的時候23.2.x已經相當穩定了我自己用下來它在Delphi 12系列上的表現比早期版本好很多。這個版本號還對應了一套內部編譯代號主要表現為它在源碼目錄結構里的命名規則。比如你用官方安裝程序裝完之后源碼目錄里會出現類似DXSources這樣的目錄結構不同組件包按VCL套件拆分。你在delphi安裝目錄下的Library路徑配置里添加的也往往是這個源碼目錄而不是只看某一個.dpk文件。這里要特別提醒一下DevExpress VCL和DevExpress FMX是兩套不同的產品標題里寫的是VCL那它只能用在VCL框架下。Delphi 12.3同時支持VCL和FMX兩種應用框架你要是想給FireMonkey移動端或者跨平臺程序用得另外找FMX對應的控件包不能混著來。1.2 Full Source版本和普通安裝包的區別Full Source最直觀的優勢就是你能看到所有控件的源碼。這不是廣告詞是實實在在能落地的能力。普通安裝包比如ExpressDLL或者編譯好的運行時BPL通常只包含.dcu、.bpl、.dpl這些編譯產物你可以在IDE里使用控件但如果運行到某個控件的內部屬性時想搞清楚它為什么會這樣工作會非常痛苦。而Full Source版本里有完整的.dpk工程文件、.pas源碼、.dfm、.res資源還有Demo項目。在IDE里按F7步進調試能直接進入到DevExpress控件的內部方法里去這對排查復雜交互問題幾乎沒有替代價值。我自己印象最深的一次是排查cxGrid在特定數據量下的內存暴漲問題。當時普通模式下只能干瞪眼后來把源碼路徑配置好在DataController的加載循環里打斷點很快就定位到了是某個事件里重復觸發了Bookmark刷新。沒有源碼的話這種問題基本只能靠猜。另外Full Source版本也是做二次定制的基礎。你完全可以在自己的工程里繼承一個TcxGrid后代類或者直接改掉DevExpress某個控件的默認行為然后把工程引用改成指向你的定制版本。這在商業項目中屬于比較敏感的操作但擁有源碼意味著你具備這個能力而不是完全被廠商鎖死。1.3 版本兼容性DevExpress 23.2.6能不能配Delphi 12.3兼容性問題是我拿到包之后第一個要確認的。Delphi 12.3在官方支持列表里DevExpress 23.2.6是明確支持的。怎么確認裝完之后在DevExpress官方文檔的Release Notes里查一下Supported RAD Studio Versions表格就行或者直接看.DPK文件命名比如文件名里帶有D12、DX12的標識一般都能對應上Delphi 12系列。不過要注意如果你本機裝了多個Delphi版本比如Delphi 10.4、11.3、12.3共存安裝DevExpress的時候它會自動檢測到所有IDE版本選擇安裝目標時最好只勾選當前需要的那一個不要一次全勾上。不然多版本混裝容易在Library路徑、BPL注冊表登記上出沖突后面IDE啟動時報一個找不到xxx.bpl的錯誤排查起來挺煩的。我這里把幾個關鍵版本的對應關系整理成了表格DevExpress VCL版本支持的RAD Studio版本關鍵注意點23.2.xRAD Studio 10.4、11.x、12.x覆蓋較長12.3可用22.2.xRAD Studio 10.4、11.x對12.0支持不完整24.1.x更高版本RAD Studio 12.x為主可能放棄部分舊版IDE判斷邏輯很簡單版本越新對老IDE的兼容性越弱但也有例外DevExpress在23.2這條線上一直維護到很靠后的補丁所以在Delphi 12.3上使用23.2.6反而是最穩妥的選擇之一。2. 安裝部署從解壓到IDE里看到控件2.1 目錄規劃和解壓要點拿到DevExpress.VCL.23.2.6.Full.Source.rar之后第一件事情不是雙擊解壓而是先規劃安裝目錄。這個步驟很多人忽視結果后面配置路徑、升級版本的時候到處留垃圾。我個人建議解壓到一個獨立且含版本號標識的目錄比如D:\Components\DevExpress\VCL\23.2.6。這樣做有兩個實際好處第一以后同時維護多個版本時不會互相覆蓋第二IDE的Library路徑里只需要維護一個指向最新版的入口換版本時改路徑比重新清理一堆殘留快得多。路徑本身最好不要有中文也不要放在桌面上。Delphi 12.3對中文路徑的處理比以前好但DevExpress的編譯腳本里有些批處理和資源文件路徑拼接邏輯在非ASCII路徑下偶爾會出現奇怪的問題所以我一直堅持全英文路徑省心。解壓的時候還有一個小細節如果你之前裝過舊版DevExpress務必先卸載干凈或者至少把舊版本的BPL、DCP從IDE的Library路徑里移除。我見過太多人直接覆蓋解壓結果IDE里同時存在兩套版本的運行時包編譯時一會兒用新包一會兒用舊包報錯時完全摸不著頭腦。2.2 用官方安裝程序還是手動編譯Full Source包解壓完之后里面通常自帶一個安裝程序比如DevExpress.VCL.Installer.exe或者一個Build腳本目錄。如果包里有官方安裝程序我強烈建議優先用安裝程序來裝它自動完成編譯、注冊、路徑配置三個步驟幾乎不會出錯。安裝程序會做下面這些事情檢測本機已安裝的RAD Studio版本根據檢測結果選擇對應的.deploy腳本或.reg注冊表配置編譯全部或選定的VCL運行時和設計時包把編譯好的BPL注冊到IDE的組件面板把源碼目錄和編譯輸出目錄寫到IDE的Library搜索路徑里。如果你不想跑安裝程序也可以手動操作流程是用IDE打開源碼目錄下的dxVCL_D12.groupproj注意文件名后綴要和你的Delphi版本匹配右鍵項目組選Build然后逐個安裝。這個方式的靈活度更高但耗時也長全量編譯一次大概十分鐘起步而且需要你對Delphi的包管理機制有一定理解。我個人推薦的做法是第一次安裝用官方安裝程序全部走默認如果中間報錯再去手動編譯對應的包排錯。這樣效率最高。2.3 配置IDE的Library路徑安裝完成后還有一個經常被忽略但至關重要的環節在Delphi 12.3的Tools Options Delphi Compiler Library里確認Library Path已經加入了DevExpress的源碼目錄和輸出目錄。很多人在IDE里能看到控件但一編譯自己的項目就報Unit not found: cxClasses.dcu之類的錯誤問題十有八九出在這里。Library搜索路徑配置不對Delphi找不到DevExpress的.dcu文件自然就無法鏈接。這里有個判斷方法如果你的工程引用了cxGrid打開工程文件.dpr在uses子句里搜一下如果能看到cxGridCustomTableView、cxGridTableView、cxGridDBTableView這些單元名說明源碼路徑被正確引入了。反之IDE會提示找不到單元。補充一下32位和64位編譯目標的輸出目錄是分開的DevExpress安裝程序會分別配置Win32和Win64的路徑。切換平臺時如果發現控件突然丟失先檢查當前平臺的Library配置里有沒有對應的輸出目錄。2.4 驗證安裝是否成功裝完以后不要急著寫代碼先做兩個快速驗證。第一個驗證新建一個VCL Application打開組件面板找到標有DevExpress的選項卡確認cxGrid、cxLookupComboBox、cxButton、dxLayoutControl這些常用組件都有圖標。隨便拖一個cxGrid到窗體上能正常顯示就說明設計時包沒壞。第二個驗證運行一下這個空窗體確認運行時沒有彈“找不到xxx.bpl”的窗口。編譯是通過了但運行類程序時需要加載對應的設計時、運行時BPL如果BPL缺失啟動時會直接報錯而且報錯信息往往比較隱晦。提示如果運行時空窗體報錯找不到cxLibrary.bpl、dxThemeManager.bpl之類的運行時包基本就是Library路徑或者BPL注冊表登記的問題。不要慌張回第2.3節檢查Library路徑然后到IDE的Component Install Packages里確認DevExpress相關的包列表都是勾選狀態。3. 幾個繞不開的核心控件實戰3.1 cxGrid網格控件的三行配置cxGrid是DevExpress VCL里使用率最高的控件沒有之一。它以一個網格容器TcxGrid加上若干層View比如TcxGridDBTableView的形式存在和普通DataSource配合來展示數據。很多人第一次接觸時覺得它層級多、屬性復雜實際上只要抓住幾條主線它就很好用。第一步在窗體上放TcxGrid和一個TDataSourceDataSource連上你的數據集比如TFDQuery、ADOQuery或者ClientDataSet。然后選中cxGrid右鍵選擇Create View選DB Table View生成一個表格視圖。第二步配置TableView和DataSource的關聯procedure TForm1.FormCreate(Sender: TObject); begin cxGrid1DBTableView1.DataController.DataSource : DataSource1; cxGrid1DBTableView1.OptionsView.ColumnAutoWidth : True; cxGrid1DBTableView1.OptionsSelection.MultiSelect : True; end;這里面DataController.DataSource是核心關聯點ColumnAutoWidth讓列寬自動撐滿網格備選項按需開啟即可。第三步通過Columns編輯器添加字段列。右鍵點擊TableView選擇Columns Editor點Add然后綁定DataBinding.FieldName為對應字段名。字段類型、下拉編輯器、排序規則都可以在這里配置。如果你從數據庫查詢數據比如在Delphi里寫一個SELECT語句配合TFDQuery加載訂單數據cxGrid立刻就能顯示出來with FDQuery1 do begin Close; SQL.Text : SELECT * FROM orders WHERE order_date BETWEEN :d1 AND :d2; ParamByName(d1).AsDateTime : Date; ParamByName(d2).AsDateTime : Date 7; Open; end;cxGrid對這類數據集沒有特殊要求只要DataSource有數據它就負責渲染、排序、過濾、分組。代碼量極低回報很高。我踩過的一個小坑默認情況下cxGrid的列會在數據源結構變化時自動恢復默認布局如果你的項目需要記住用戶的列寬和排序方式記得把TableView的OptionsCustomize.ColumnHiding和OptionsCustomize.ColumnsQuickCustomization打開再配合LayoutHelper或者自己存注冊表來實現布局持久化。3.2 cxLookupComboBox下拉聯動cxLookupComboBox是另一個高頻組件它在普通下拉框的基礎上增加了數據綁定能力。常見的場景是選擇某一個分類后另一個下拉框自動顯示該分類下的子項目。核心屬性是Properties.ListSource、Properties.ListFieldNames和Properties.KeyFieldNames。比如我要做一個“先選省份再選城市”的聯動下拉先在窗體上放兩個cxLookupComboBox都指定好各自的ListSource比如qryProvince和qryCity。省份下拉不需要聯動直接綁定即可城市下拉需要在省份的EditValue改變事件里動態過濾數據集procedure TForm1.cxLookupComboBox1PropertiesEditValueChanged(Sender: TObject); begin qryCity.Close; qryCity.SQL.Text : SELECT * FROM city WHERE province_id :pid; qryCity.ParamByName(pid).AsInteger : VarAsType(cxLookupComboBox1.EditValue, varInteger); qryCity.Open; cxLookupComboBox2.Properties.ListSource.DataSet : qryCity; cxLookupComboBox2.Properties.KeyFieldNames : city_id; cxLookupComboBox2.Properties.ListFieldNames : city_name; end;有一個細節要注意EditValue的類型可能是variant直接轉Integer前最好用VarIsNull判斷一下避免未選擇時觸發一次空值過濾把數據集給刷空。這個問題在聯動的第二級、第三級下拉里最常見處理方式就是加一個空值攔截。下拉控件還有一點實用技巧Properties.DropDownListStyle設為lsEditFixedList時用戶只能從列表里選不能自己打字如果允許模糊搜索可以把Properties.IncrementalFiltering打開實時過濾候選列表體驗直接上一個檔次。3.3 布局與間距調整dxLayoutControl的使用DevExpress布局容器在正式項目中幾乎必用。相比裸用Panel和Anchor屬性dxLayoutControl能幫你自動處理子控件之間的間距、對齊方式以及縮放行為尤其適合做單據錄入界面、參數配置界面。比如一個表格布局左邊一列是Label右邊是輸入框放一個TdxLayoutControl到窗體上在控件上右鍵選擇Add Item添加一個LayoutItem把LayoutItem的Caption設為“客戶名稱”再把一個TcxTextEdit拖到這個Item內部讓Item作為容器承載它復制出多行類似Item設置每行Item的AlignHorz為ahClientLayoutControl會自動把控件拉伸到可用寬度。間距調整是另一個高頻需求。很多人在Delphi群里問“子控件間距怎么調”其實在dxLayoutControl里就兩個關鍵屬性OptionsItem.SpacingHorz和OptionsItem.SpacingVert。前者控制水平間距后者控制垂直間距單位都是像素。想讓某一行和其他行拉開距離在對應Item的OptionsItem里單獨改SpacingVert即可。實際項目里我習慣把Container的中間區域都交給LayoutControl只在最外層留一個主Panel負責整體縮放。這樣不管用戶把窗口拉伸到全屏還是縮成一個窄條控件之間都不會互相壓疊或留出大片空白。3.4 圖片顯示與局部放大熱詞里有人搜“picturebox控件局部放大”在數據化管理類軟件里這其實是個很常見的需求商品圖片預覽、圖紙瀏覽、監控截圖回放。DevExpress里對應的是TcxImage基礎用法是設置圖片和縮放模式cxImage1.Properties.Stretch : True; cxImage1.Properties.Proportional : True; cxImage1.Properties.FitMode : ifmFit;Proportional為True時圖片會保持寬高比不會變形FitMode有三個關鍵值ifmFit整體顯示在控件內、ifmStretch拉伸填滿、ifmNoScale按原始大小顯示。我這里推薦默認用ifmFit它既能看全圖又不會變形。局部放大比整體縮放復雜一點我的做法是在鼠標移動事件里實時計算放大區域然后借助一個TForm或者TdxCameraControl之類的輔助元素來顯示細節。如果只是想在同一個控件上畫出放大選框可以用Canvas直接畫矩形procedure TForm1.cxImage1MouseMove(Sender: TObject; Shift: TShiftState; X, Y: Integer); begin cxImage1.Canvas.DrawFocusRect(Rect(X - 30, Y - 30, X 30, Y 30)); end;這只是畫一個矩形框真正的局部放大要在MouseMove里源圖對應區域做二次繪制。一個簡潔方案是源圖保存在一個TBitmap里鼠標移動時用StretchBlt把源圖的對應區域放大到某個TPaintBox上。這套邏輯寫起來不算復雜但需要注意坐標換算特別是控件有縮放、圖片不是原始大小時計算坐標時要拿圖片實際尺寸和顯示尺寸做比例換算。4. 日常開發中最容易踩的坑4.1 控件丟失、IDE里找不到DevExpress選項卡這個問題在熱詞里反復出現現象是每次重新打開Delphi組件面板上的DevExpress選項菜單不在了或者拖到窗體上的控件直接報錯。我遇到過不下十次原因基本可以歸納成三類。第一類BPL版本和IDE版本不匹配。你安裝了針對Delphi 11的DevExpress包然后在Delphi 12.3里打開組件面板注冊表里登記的BPL還是舊版本IDE加載時要么忽略要么直接崩潰。解決辦法是重裝對應版本的安裝包不要手動拷貝BPL。第二類運行時包依賴缺失。DevExpress控件運行依賴若干個基礎運行時包比如cxLibrary.bpl、dxCore.bpl如果這些包缺失或版本舊IDE啟動時也會把整個DevExpress選項卡拿掉。檢查方式是看看Component Install Packages頁面里有沒有條目顯示為“未安裝”或“加載失敗”。第三類路徑配置被清理。新裝了其他第三方控件后某些安裝程序會重寫Library路徑把DevExpress的搜索路徑給擠掉了。處理方式很簡單回第2.3節重新補上即可。4.2 編譯報錯和路徑沖突常見報錯有很多種這里挑三個出現頻率最高的。一是“File not found: cxClasses.dcu”。這是Library路徑沒配上或者路徑里指向了舊版本源碼目錄。檢查當前平臺Win32/Win64的Library路徑是否正確。二是“F2046: File not found: dxBar.dcu”。這個一般是在工程里引用了某個DevExpress單元但該單元對應的源碼目錄不在搜索路徑里。解決辦法是把DevExpress源碼根目錄和Output目錄都加進Library路徑或者把缺失的具體目錄補上。三是“E2201: This implementation file cannot be compiled with the current compiler”。這個在手動編譯源碼包時偶爾出現多半是版本對應關系不對比如用編譯Delphi 12的.dpk文件時IDE里卻切換到Delphi 11的編譯器。熱詞里“delphi 控件版本問題導致每次進入ide都丟失控件需要重新放置”這個場景本質上是設計時包注冊失敗或運行時包加載失敗和上面第一類原因高度重合。我建議把IDE面板里的包檢查一遍確保所有DevExpress相關包都是勾選狀態然后重啟IDE。如果還不行就直接卸載重裝DevExpress比手動修復注冊表快得多。4.3 升級和卸載注意事項DevExpress Full Source的升級路徑比較特殊。從23.2.5升到23.2.6最穩妥的方式是卸載舊版本清理干凈再安裝新版本。不要想著在原目錄上覆蓋解壓因為源碼文件的增減、工程結構的調整都可能導致一個以前編譯過的.dcu文件殘留繼續污染新版本的編譯。卸載時要做的三件事第一在控制面板卸載DevExpress相關程序第二刪除IDE的Library路徑里舊版本的源碼和輸出目錄引用第三檢查Delphi根目錄下的BPL、DCP目錄把名字帶DevExpress或dx開頭的舊文件清掉前提是確認沒有其他工程還在引用舊包。這幾個步驟不能省。我見過有人只是簡單卸載后裝了新版本結果IDE啟動時同時加載了舊版dxBar.bpl和新版cxGrid.dcu編譯期碰運氣運行期直接崩。根源就是卸載不徹底殘留的舊BPL和新版本設計時包沖突。4.4 調試與斷點進入源碼的技巧如果你裝的是Full Source不利用源碼調試能力就太虧了。在Delphi 12.3里進入DevExpress源碼調試需要兩個前提條件。第一個Library路徑里必須包含DevExpress源碼目錄這樣編譯器拿到的是源碼路徑而不是純.dcu地址否則調試器按F7會直接跳出說你沒有這個單元的源碼。第二個禁用對應的運行時包調試優化。在Project Options Runtime Packages里如果你把控件打包為BPL運行時是不會進入源碼的。臨時調試可以取消勾選對應包的Build with runtime packages或者干脆把整個工程改為靜態鏈接模式源碼調試會更流暢。注意靜態鏈接模式下編譯出的exe會變大幾十MB正式發布時一般建議回到運行時包模式減小體積。調試和發布分開處理這個習慣很重要。5. 我的一些使用體會說實話DevExpress VCL這套控件庫的功能量級很大文檔也厚得嚇人。我最初接觸的時候也走過彎路一上來就想把每個控件都摸清楚結果花了很多時間卻什么都沒吃透。后來形成的做法是先掌握cxGrid、cxLookupComboBox、cxButton、dxLayoutControl這幾個主力控件拿它們把常見的業務界面搭出來然后再根據項目需要逐個突破其他高級能力比如圖表、報表、皮膚切換。另外一個很實際的經驗是Full Source版本在調試階段價值巨大但不要輕易去改源碼目錄里的內容。你改掉某個.pas文件后重新Build雖然能通過但這個改動是局部的一旦以后升級版本這個修改就被覆蓋掉了而且你很可能已經忘了自己改過什么。如果確實需要自定義最好繼承一個子類或者在項目代碼里通過事件和屬性級別去實現把改動范圍控制在業務層。當前這個版本我在一個中型進銷存項目里跑了幾個月編譯出的32位程序、64位程序都穩定運行界面加載速度、數據量上萬行的網格操作流暢度都在可接受范圍內。內存泄漏、異常崩潰這類問題沒有出現過。對于希望穩定、可控、界面又想要現代感的桌面應用開發場景Delphi 12.3加DevExpress VCL 23.2.6 Full Source這套組合值得認真考慮。本文還有配套的精品資源點擊獲取