簡(jiǎn)介這是一份基于Qt 5框架的FTP上傳下載工具源碼面向需要快速實(shí)現(xiàn)FTP客戶端的C開(kāi)發(fā)者尤其適合在Windows、Linux及嵌入式Linux上構(gòu)建跨平臺(tái)應(yīng)用。項(xiàng)目中直接集成了QFtp相關(guān)實(shí)現(xiàn)無(wú)需單獨(dú)下載編譯QFtp類通過(guò)QNetworkAccessManager與QFtp完成服務(wù)器連接、用戶登錄以及文件的上傳和下載并利用信號(hào)與槽機(jī)制實(shí)時(shí)反饋進(jìn)度方便后續(xù)擴(kuò)展上傳邏輯和錯(cuò)誤處理。壓縮包共12個(gè)文件以cpp源文件、h頭文件、ui界面文件、pro工程文件為主包含完整的工程配置與界面定義另附png預(yù)覽圖包體僅32KB結(jié)構(gòu)精簡(jiǎn)適合直接閱讀和二次開(kāi)發(fā)。代碼按照主邏輯、FTP交互和界面進(jìn)行了基本劃分讀起來(lái)清晰移植到現(xiàn)實(shí)項(xiàng)目中也很方便。目前已有1095人學(xué)習(xí)參考開(kāi)發(fā)者可以借此掌握Qt 5中FTP客戶端的基礎(chǔ)實(shí)現(xiàn)思路并在其基礎(chǔ)上加入FTPS或SFTP等加密傳輸機(jī)制提升實(shí)際應(yīng)用中的數(shù)據(jù)安全性。 平時(shí)做網(wǎng)絡(luò)調(diào)試和嵌入式開(kāi)發(fā)經(jīng)常需要往開(kāi)發(fā)板、服務(wù)器或者局域網(wǎng)里的其他設(shè)備傳文件。用現(xiàn)成的FTP客戶端不是不行但遇到定制化需求——比如批量上傳固件、按日期自動(dòng)下載日志、給非技術(shù)人員一個(gè)傻瓜式操作界面——就開(kāi)始別扭了。后來(lái)抽時(shí)間用Qt把上傳下載這些功能整理成了一個(gè)小工具順帶把源碼也捋清楚了。這篇就把整個(gè)實(shí)現(xiàn)思路、踩過(guò)的坑和關(guān)鍵代碼拆開(kāi)講給打算自己寫(xiě)FTP工具的兄弟一個(gè)參考。1. 需求復(fù)盤為什么現(xiàn)成的FTP客戶端不夠用1.1 項(xiàng)目背景與工具定位先說(shuō)說(shuō)這工具是干嘛的。當(dāng)時(shí)手頭有個(gè)項(xiàng)目需要維護(hù)分布在現(xiàn)場(chǎng)的一批設(shè)備。設(shè)備上有FTP服務(wù)日常要傳配置文件、升級(jí)固件包、拉取運(yùn)行日志。設(shè)備數(shù)量一多每次打開(kāi)FileZilla一個(gè)個(gè)連手輸IP、用戶名、密碼再拖拽文件重復(fù)勞動(dòng)特別重。更麻煩的是現(xiàn)場(chǎng)操作的人不一定是技術(shù)人員你不可能要求他們?nèi)ダ斫釬TP的主動(dòng)模式被動(dòng)模式、目錄權(quán)限這些問(wèn)題。所以這個(gè)工具的核心定位很明確面向特定場(chǎng)景的、簡(jiǎn)化操作的FTP傳輸工具。它不需要做到FileZilla那么全但要把高頻操作做到點(diǎn)一下就能完成。界面用Qt做跨平臺(tái)一套源碼在Windows、Linux、麒麟系統(tǒng)上都能編譯這一點(diǎn)對(duì)工控和國(guó)產(chǎn)化場(chǎng)景很重要。1.2 功能清單與使用場(chǎng)景工具最終聚焦在四個(gè)核心功能上連接管理和會(huì)話保存把常用設(shè)備的地址、端口、賬號(hào)密碼保存下來(lái)下次直接選中自動(dòng)連接目錄瀏覽和文件列表支持進(jìn)入子目錄、返回上級(jí)、刷新列表上傳和下載支持單個(gè)文件和批量隊(duì)列帶進(jìn)度顯示傳輸日志記錄每次操作的成敗、耗時(shí)、文件大小方便事后排查使用場(chǎng)景上最典型的就是批量推送固件?，F(xiàn)場(chǎng)幾十臺(tái)設(shè)備提前把設(shè)備列表做成配置文件工具啟動(dòng)后自動(dòng)加載勾選要升級(jí)的設(shè)備選擇固件包一鍵批量上傳。升級(jí)完再批量拉取每臺(tái)設(shè)備的版本信息文件。整個(gè)過(guò)程不需要人盯著傳完看日志就行。2. 技術(shù)選型Qt生態(tài)里搞FTP傳輸?shù)乃臈l路寫(xiě)Qt程序做FTP傳輸擺在面前的不止一條路。我先把當(dāng)時(shí)對(duì)比過(guò)的幾種方案列出來(lái)各有各的坑。2.1 QFtp庫(kù)經(jīng)典但需要自己搞到Qt4時(shí)代內(nèi)置了QFtp類專門用來(lái)做FTP客戶端。但Qt5之后官方把模塊從主庫(kù)中移除了現(xiàn)在想用就得手動(dòng)下載源碼編譯或者通過(guò)git submodule拉取。這個(gè)庫(kù)是異步的用信號(hào)和槽驅(qū)動(dòng)狀態(tài)機(jī)寫(xiě)起來(lái)思路清晰。QFtp支持的指令很完整connectToHost、login、list、get、put、rename、remove、mkdir、cd不用自己拼FTP命令封裝層幫你處理了。它的get和put支持QFtp::TransferType可以按二進(jìn)制或ASCII模式傳輸。除此之外QFtp在底層幫你處理了數(shù)據(jù)連接是主動(dòng)還是被動(dòng)的問(wèn)題不需要你手動(dòng)去解析PORT、PASV這些響應(yīng)碼。選擇QFtp最大的原因是老項(xiàng)目的慣性。搜索qt ftp 上傳下載 源碼能找到大量基于QFtp的現(xiàn)成實(shí)現(xiàn)學(xué)習(xí)成本低。缺點(diǎn)就是它確實(shí)老了代碼風(fēng)格停留在Qt4時(shí)代沒(méi)有QML集成也不維護(hù)了。2.2 QNetworkAccessManager內(nèi)置但功能有限Qt5/Qt6內(nèi)置的QNetworkAccessManager支持ftp://協(xié)議的URL。用起來(lái)也很簡(jiǎn)單構(gòu)造一個(gè)QNetworkRequest把URL傳進(jìn)去然后調(diào)用get或者put就行。這個(gè)方案最大的優(yōu)勢(shì)是省事不需要額外編譯任何庫(kù)QNetworkAccessManager是QtNetwork模塊的一部分加個(gè)QT network就能用。但它的問(wèn)題在于功能過(guò)于基礎(chǔ)只支持匿名單文件傳輸不支持列目錄不支持?jǐn)帱c(diǎn)續(xù)傳也不支持主動(dòng)模式主動(dòng)連接。你要實(shí)現(xiàn)瀏覽目錄、選擇文件下載這個(gè)基本交互靠它根本做不了。搜熱點(diǎn)詞里springboot 如何上傳下載大文件這類問(wèn)題多后端場(chǎng)景里大文件傳輸是高頻需求。在Qt這邊QNetworkAccessManager做小文件、內(nèi)網(wǎng)傳輸、一次性傳完這種夠了但只要涉及目錄交互、斷點(diǎn)續(xù)傳立刻暴露短板。2.3 libcurl與純Socket再進(jìn)階一點(diǎn)的方案是引入libcurl。libcurl功能強(qiáng)大FTP、FTPS、SFTP都支持還能做斷點(diǎn)續(xù)傳、限速、代理。Qt程序可以通過(guò)C接口調(diào)libcurl在子線程里做阻塞傳輸然后通過(guò)信號(hào)把進(jìn)度發(fā)回GUI線程。這個(gè)方案功能上限高但引入了一個(gè)重量級(jí)第三方依賴Windows下編譯libcurl需要處理依賴庫(kù)跨平臺(tái)分發(fā)時(shí)DLL一大堆。還有一種路子是純Socket實(shí)現(xiàn)FTP協(xié)議。FTP協(xié)議本身不算復(fù)雜控制連接走命令數(shù)據(jù)連接走文件內(nèi)容但要把主動(dòng)模式被動(dòng)模式、ASCII和二進(jìn)制模式、響應(yīng)碼解析、目錄列表解析這些全部處理好工作量不小。除非是學(xué)習(xí)目的或者有極端的定制需求否則沒(méi)必要重復(fù)造輪子。2.4 我最終的選擇綜合下來(lái)我選了QFtp作為傳輸核心。原因很實(shí)在對(duì)比項(xiàng)QFtpQNetworkAccessManagerlibcurl獲取方式源碼編譯Qt內(nèi)置第三方庫(kù)目錄列表支持不支持支持?jǐn)帱c(diǎn)續(xù)傳支持不支持支持主動(dòng)/被動(dòng)模式支持僅被動(dòng)支持學(xué)習(xí)成本低低高維護(hù)狀態(tài)停滯隨Qt更新活躍QFtp雖然不維護(hù)了但FTP協(xié)議十幾年來(lái)沒(méi)有大變化這個(gè)庫(kù)的穩(wěn)定性經(jīng)過(guò)了大量項(xiàng)目的驗(yàn)證對(duì)于內(nèi)網(wǎng)工具來(lái)說(shuō)足夠用。重點(diǎn)是我后面要做斷點(diǎn)續(xù)傳、隊(duì)列管理QFtp的信號(hào)槽模式非常適合做這些擴(kuò)展。提示Qt6環(huán)境下編譯QFtp需要先編譯qtbase然后單獨(dú)拉QFtp源碼用qmake或cmake編譯。建議直接去Qt官方代碼倉(cāng)庫(kù)拉取qt/qtftp。3. 核心流程拆解登錄、列表、下載、上傳的代碼實(shí)現(xiàn)3.1 會(huì)話管理與登錄狀態(tài)機(jī)QFtp是異步操作每個(gè)命令都有一個(gè)對(duì)應(yīng)信號(hào)反饋結(jié)果。正確的做法是維護(hù)一個(gè)狀態(tài)機(jī)空閑Idle、連接中Connecting、已連接Connected、已登錄LoggedIn、傳輸中Transferring。狀態(tài)機(jī)到位了才能防止用戶在傳輸過(guò)程中亂點(diǎn)按鈕導(dǎo)致?tīng)顟B(tài)錯(cuò)亂。連接登錄的核心代碼長(zhǎng)這樣m_ftp new QFtp(this); connect(m_ftp, QFtp::stateChanged, this, FtpWorker::onStateChanged); connect(m_ftp, QFtp::commandFinished, this, FtpWorker::onCommandFinished); connect(m_ftp, QFtp::listInfo, this, FtpWorker::onListInfo); connect(m_ftp, QFtp::dataTransferProgress, this, FtpWorker::onDataTransferProgress); m_ftp-connectToHost(host, port); m_ftp-login(user, password);這里要留個(gè)心眼connectToHost和login是兩條命令QFtp內(nèi)部通過(guò)發(fā)送命令隊(duì)列來(lái)處理但外部能感知的就是commandFinished(int id, bool error)。這個(gè)信號(hào)里返回的id對(duì)應(yīng)你調(diào)用命令時(shí)返回的那個(gè)id所以你需要自己維護(hù)一個(gè)QHashint, QString來(lái)記錄每個(gè)id對(duì)應(yīng)的是login、list還是get不然回調(diào)里根本分不清是哪個(gè)命令完成了。登錄狀態(tài)判斷不能直接用stateChanged里的枚舉值因?yàn)長(zhǎng)oggingIn狀態(tài)時(shí)間極短很容易漏掉。穩(wěn)妥做法是在commandFinished的id匹配到login返回值時(shí)用QFtp的currentCommand()做二次確認(rèn)。3.2 目錄列表解析與中文亂碼處理列目錄這個(gè)操作QFtp通過(guò)list()命令拿服務(wù)器的列表。服務(wù)器返回的原始內(nèi)容會(huì)觸發(fā)listInfo信號(hào)參數(shù)是QUrlInfo對(duì)象里面把文件名、大小、權(quán)限、修改時(shí)間都解析好了不用自己啃字符串。void FtpWorker::onListInfo(const QUrlInfo info) { if (info.isDir() !info.isSymLink()) { // 目錄項(xiàng) } else { // 文件項(xiàng) } }但這里有一個(gè)繞不開(kāi)的坑中文文件名亂碼。FTP協(xié)議規(guī)范里面的文件名編碼是拉丁-1后來(lái)為了兼容中文服務(wù)器端比如vsftpd、Serv-U一般會(huì)用UTF-8或者GBK去返回。QFtp源碼里用的是QString::fromLatin1()解析列表段遇到中文就全亂套了。我的做法是給QFtp的list()命令增加一個(gè)子類重寫(xiě)或者在listInfo信號(hào)返回之后對(duì)info.name()按UTF-8重新解碼一遍QString rawName info.name(); QByteArray rawBytes rawName.toLatin1(); QString correctName QString::fromUtf8(rawBytes);這個(gè)方法實(shí)測(cè)對(duì)vsftpd默認(rèn)UTF-8編碼的服務(wù)器有效。老破服務(wù)器如果是GBK編碼就需要改成QString::fromLocal8Bit()或者手動(dòng)指定QTextCodec去解。不同現(xiàn)場(chǎng)不同的FTP服務(wù)器這個(gè)編碼設(shè)置最后是做成了配置項(xiàng)讓用戶自己選。注意有些FTP服務(wù)器在返回中文文件名時(shí)傳輸層會(huì)把UTF-8字節(jié)拆成兩段返回導(dǎo)致亂碼修復(fù)后仍然偶爾出錯(cuò)。遇到這種情況最好在服務(wù)器端統(tǒng)一文件名編碼或者建一個(gè)映射表。3.3 上傳下載流程與進(jìn)度回調(diào)下載文件就是get()上傳就是put()。QFtp的get會(huì)打開(kāi)一個(gè)QIODevice文件數(shù)據(jù)通過(guò)設(shè)備傳入傳去。實(shí)現(xiàn)下載時(shí)定義一個(gè)QFile打開(kāi)方式為WriteOnly上傳時(shí)文件打開(kāi)方式為ReadOnly。// 下載 QFile *file new QFile(localPath); if (!file-open(QIODevice::WriteOnly | QIODevice::Truncate)) { qWarning() open local file failed; return; } int id m_ftp-get(remotePath, file, QFtp::Binary); // 上傳 QFile *uploadFile new QFile(localPath); if (!uploadFile-open(QIODevice::ReadOnly)) { qWarning() open local file failed; return; } int id m_ftp-put(uploadFile, remotePath, QFtp::Binary);這里的put有個(gè)細(xì)節(jié)QFtp會(huì)調(diào)用QIODevice::size()來(lái)確定要傳的文件大小如果設(shè)備傳的是QTcpSocket或緩沖設(shè)備size可能不準(zhǔn)。所以上傳時(shí)最好傳QFile對(duì)象不要傳QByteArray包裝除非你確定文件整體小到可以全部載入內(nèi)存。進(jìn)度回調(diào)走的是dataTransferProgress(qint64 done, qint64 total)這個(gè)信號(hào)在數(shù)據(jù)連接傳輸過(guò)程中持續(xù)觸發(fā)。注意它只代表當(dāng)前這條命令的傳輸進(jìn)度你在隊(duì)列里連續(xù)傳多個(gè)文件時(shí)每次進(jìn)入新的gettotal會(huì)重置成當(dāng)前文件的大小。UI上的進(jìn)度條要在每個(gè)文件開(kāi)始時(shí)歸零不然會(huì)出現(xiàn)進(jìn)度條倒退。4. 斷點(diǎn)續(xù)傳和文件校驗(yàn)讓工具變得可靠的細(xì)節(jié)4.1 resume參數(shù)與seek實(shí)現(xiàn)QFtp的get和put簽名里有一個(gè)第三參數(shù)TransferType但斷點(diǎn)續(xù)傳不是靠這個(gè)完成的。QFtp原始版本對(duì)斷點(diǎn)續(xù)傳的支持比較隱晦你需要先拿到服務(wù)器上文件的大小然后作為get的第四參數(shù)傳進(jìn)去。m_ftp-get(remotePath, file, QFtp::Binary, resumeOffset);這個(gè)resumeOffset傳入了FTP協(xié)議層面的REST命令服務(wù)器會(huì)從指定的偏移量開(kāi)始發(fā)送數(shù)據(jù)。本地文件需要先seek()到同樣的偏移量才能正確地接著寫(xiě)。換句話說(shuō)斷點(diǎn)續(xù)傳的完整流程是檢查本地文件的大小作為初始偏移量調(diào)用get(remotePath, file, QFtp::Binary, localFileSize)本地文件seek到localFileSize接收數(shù)據(jù)并追加寫(xiě)入傳輸完成后比對(duì)總大小確認(rèn)一致上傳的斷點(diǎn)續(xù)傳更麻煩QFtp沒(méi)有直接提供從第N字節(jié)開(kāi)始傳的API。需要服務(wù)器支持REST才會(huì)作用于STOR命令QFtp源碼里把resumeOffset同時(shí)用于get和put但實(shí)際測(cè)試發(fā)現(xiàn)對(duì)上傳來(lái)說(shuō)偏移量的指示并不總是有效。我的建議是斷點(diǎn)續(xù)傳優(yōu)先保證下載方向。上傳如果需要續(xù)傳就改成先查服務(wù)器文件大小再?zèng)Q定是全量覆蓋還是跳過(guò)。如果服務(wù)器上已有同名文件且大小和本地一致默認(rèn)直接跳過(guò)當(dāng)成已上傳處理。雖然粗暴但實(shí)際使用中省了很多事。4.2 大文件傳輸?shù)膬?nèi)存控制大文件傳輸最容易踩的坑是強(qiáng)行用readAll()把整個(gè)文件讀進(jìn)內(nèi)存。一個(gè)2GB的固件包32位的程序內(nèi)存直接爆掉。QFtp的設(shè)計(jì)本身就規(guī)避了這個(gè)問(wèn)題它不要求你一次性提供全部數(shù)據(jù)get/put內(nèi)部通過(guò)QIODevice流式讀寫(xiě)底層socket的收發(fā)緩沖控制了峰值內(nèi)存占用。但還是有一處要注意dataTransferProgress信號(hào)觸發(fā)頻率很高GUI線程里如果每次都去更新進(jìn)度條樣式、重繪窗口界面會(huì)卡頓。我的做法是加一個(gè)節(jié)流閥只有變化超過(guò)0.1秒才刷新UIif (m_lastUpdateTime.msecsTo(QDateTime::currentDateTime()) 100) return; m_lastUpdateTime QDateTime::currentDateTime(); emit progressUpdated(done, total);4.3 錯(cuò)誤恢復(fù)與日志FTP傳輸過(guò)程中不管是網(wǎng)絡(luò)斷開(kāi)還是服務(wù)器主動(dòng)關(guān)閉連接QFtp都會(huì)把錯(cuò)誤通過(guò)commandFinished返回。捕獲錯(cuò)誤的邏輯要細(xì)致case QFtp::Connecting: ... case QFtp::Connected: ... case QFtp::LoggedIn: ... default: break;更實(shí)用的做法是記錄一條交易日志開(kāi)始時(shí)間、結(jié)束時(shí)間、文件名、目標(biāo)路徑、成功/失敗、重試次數(shù)。我在工具里用QFile把日志追加寫(xiě)到一個(gè)純文本文件里同時(shí)往UI的日志窗口輸出。這樣批量傳輸完只需要看最后的匯總統(tǒng)計(jì)就知道成功了幾條、失敗了幾條。日志格式保持純文本別用數(shù)據(jù)庫(kù)現(xiàn)場(chǎng)拷日志方便。5. 界面與隊(duì)列管理多任務(wù)處理的設(shè)計(jì)思路5.1 任務(wù)隊(duì)列的數(shù)據(jù)結(jié)構(gòu)工具支持批量任務(wù)核心就是一個(gè)任務(wù)隊(duì)列。每個(gè)任務(wù)封裝成一個(gè)結(jié)構(gòu)體struct FtpTask { int id; QString remotePath; QString localPath; bool isUpload; // true上傳, false下載 int status; // 0: 等待, 1: 傳輸中, 2: 成功, 3: 失敗 qint64 totalBytes; qint64 finishedBytes; QString errorMessage; };隊(duì)列用QQueueFtpTask管理。傳輸循環(huán)的邏輯是從隊(duì)列頭部彈出任務(wù)調(diào)用QFtp執(zhí)行等commandFinished返回后再?gòu)椣乱粋€(gè)。這里不要用發(fā)射信號(hào)后自動(dòng)下一個(gè)的消息循環(huán)寫(xiě)法容易在異常狀態(tài)下卡死。直接在commandFinished里判斷狀態(tài)機(jī)是否空閑空閑才處理隊(duì)列void FtpWorker::processNextTask() { if (m_ftp-state() ! QFtp::LoggedIn) return; if (m_currentTask.status 1) return; if (m_taskQueue.isEmpty()) { emit allFinished(); return; } // 彈出任務(wù)并執(zhí)行 }一次只傳一個(gè)文件看起來(lái)傻但實(shí)現(xiàn)最簡(jiǎn)單邏輯最不容易出錯(cuò)。真要多線程并發(fā)傳輸需要為每個(gè)QFtp對(duì)象單獨(dú)搞一個(gè)工作線程信號(hào)槽跨線程傳遞會(huì)更復(fù)雜。實(shí)測(cè)內(nèi)網(wǎng)傳輸單線程FTP速度通常就能跑滿帶寬不一定非要并發(fā)。5.2 進(jìn)度條和狀態(tài)刷新UI上用QTableWidget展示任務(wù)列表每一行是一個(gè)文件列分別是文件名、方向、大小、進(jìn)度、狀態(tài)。進(jìn)度條直接放在單元格里用setCellWidget塞一個(gè)QProgressBar進(jìn)去。刷新策略是整個(gè)界面用一個(gè)QTimer500毫秒觸發(fā)一次把所有活躍任務(wù)的進(jìn)度拉過(guò)來(lái)批量更新m_progressTimer-start(500); connect(m_progressTimer, QTimer::timeout, this, [this]() { for (int i 0; i m_taskList.size(); i) { auto task m_taskList[i]; if (task.bar) { task.bar-setValue(percent(task)); } } });這個(gè)設(shè)計(jì)比每次都update來(lái)得穩(wěn)。批量上傳100個(gè)文件時(shí)如果每個(gè)文件都頻繁發(fā)送信號(hào)去刷新界面主線程會(huì)被UI事件淹沒(méi)。用定時(shí)器聚攏更新CPU占用小很多。6. 編譯打包與常見(jiàn)運(yùn)行報(bào)錯(cuò)6.1 在.pro里配置QFtpQFtp在Qt5/Qt6下需要單獨(dú)編譯引入方式有兩種方式一是把qtftp的源碼直接塞進(jìn)自己的項(xiàng)目里。將qftp.pro子目錄掛到主項(xiàng)目下主.pro里加QT network widgets include(qtftp/qftp.pri)方式二是先單獨(dú)編譯qtftp庫(kù)然后鏈接。個(gè)人推薦直接包含源碼省去安裝路徑的配置這對(duì)跨平臺(tái)部署更友好。編譯完成后.pro里記得加網(wǎng)絡(luò)模塊QT network否則會(huì)報(bào)未定義引用。有些環(huán)境還需要打開(kāi)QPaintEngine相關(guān)開(kāi)關(guān)但FTP加界面一般用不到3D、OpenGL之類不必理會(huì)。6.2 windeployqt打包與platform plugin報(bào)錯(cuò)工具開(kāi)發(fā)完發(fā)給別人用時(shí)最先遇到的就是windows no qt platform plugin could be initialized這個(gè)報(bào)錯(cuò)。說(shuō)白了就是運(yùn)行目錄下缺platforms/qwindows.dll。用windeployqt打包時(shí)控制臺(tái)執(zhí)行windeployqt FtpTool.exe --release --no-opengl-sw跑完后檢查運(yùn)行目錄下有沒(méi)有platforms文件夾。如果沒(méi)有手動(dòng)從Qt安裝目錄.copy過(guò)去。還有一個(gè)容易忽略的是如果你用的是MSVC編譯的Qt目標(biāo)機(jī)器需要安裝對(duì)應(yīng)的vc_redist.x64.exe否則程序雙擊沒(méi)反應(yīng)。打包時(shí)建議把FTP也用到的OpenSSL依賴一起處理。QFtp默認(rèn)不做FTPS加密如果你加了QSslSocket支持打包時(shí)需帶上libcrypto-3-x64.dll和libssl-3-x64.dll否則連FTP都是好的連FTPS直接崩。注意Qt6的QFtp庫(kù)編譯后除了依賴QtNetwork還依賴QtCore、QtGui、QtWidgetswindeployqt會(huì)自動(dòng)識(shí)別部分依賴但QtFtp動(dòng)態(tài)庫(kù)本身不一定能被自動(dòng)掃描到。保險(xiǎn)起見(jiàn)把Qt6Ftp.dll或Qt5Ftp.dll手動(dòng)復(fù)制到打包目錄。6.3 運(yùn)行時(shí)報(bào)錯(cuò)與卡死的排查套路實(shí)際使用中遇到最多的問(wèn)題有三個(gè)第一個(gè)是FTP復(fù)制文件出錯(cuò)。這類錯(cuò)誤大多發(fā)生在文件名編碼不一致或服務(wù)器的目錄權(quán)限上。先是確認(rèn)連接正常再確認(rèn)遠(yuǎn)程目錄可寫(xiě)最后確認(rèn)本地路徑不是中文且權(quán)限正常。第二個(gè)是無(wú)法與服務(wù)器建立連接。先手動(dòng)用命令行ping通不通再用FileZilla連一次確認(rèn)服務(wù)器正常最后看工具里填的端口是否正確。FTP默認(rèn)是21但很多嵌入式設(shè)備上FTP端口是改過(guò)的要注意工具里的端口設(shè)置有沒(méi)有被默認(rèn)值覆蓋。第三個(gè)是連接成功后列表遲遲不出數(shù)據(jù)。多半是目錄列表格式和QFtp內(nèi)置的解析器不匹配。老掉牙的Windows FTP服務(wù)器返回的列表格式和Linux vsftpd不一致QFtp的list()命令對(duì)格式兼容性一般。如果遇到這種直接改用rawList()拿原始輸出然后自己解析一行行的文本。雖然工作量大點(diǎn)但穩(wěn)定。我在實(shí)際做的時(shí)候還在工具里加了一個(gè)測(cè)試連接按鈕和一個(gè)診斷信息面板點(diǎn)擊之后會(huì)把控制連接上發(fā)的命令和服務(wù)器返回的響應(yīng)碼全部打出來(lái)。排查問(wèn)題的時(shí)候這個(gè)面板比斷點(diǎn)調(diào)試還管用——FTP協(xié)議是明文文本命令一行命令一行響應(yīng)看清楚了就能定位。7. 我在實(shí)際使用過(guò)程中的幾個(gè)補(bǔ)充工具做完用了大半年慢慢沉淀出幾個(gè)實(shí)用技巧。首先QFtp的list()命令會(huì)把當(dāng)前路徑下的所有條目一次性傳完在listInfo信號(hào)中累積條目等commandFinished匹配到list命令后一次性把整個(gè)列表發(fā)給UI。千萬(wàn)別在listInfo里逐條追加到表格否則表格刷新次數(shù)太多目錄文件多了會(huì)明顯卡頓。其次在UI上提供一個(gè)保存會(huì)話功能很有必要。把IP、端口、賬號(hào)、密碼、初始路徑、編碼方式、文件列表排序方式全保存下來(lái)下次啟動(dòng)自動(dòng)恢復(fù)?，F(xiàn)場(chǎng)甲方幾乎不會(huì)記憶這些東西一個(gè)會(huì)話配置文件省去大量客服溝通成本。最后FTP工具作為內(nèi)部工具最終使用頻率最高的功能往往不是你以為的那個(gè)。這個(gè)工具做出來(lái)后用得最多的是批量下載日志因?yàn)樵O(shè)備出問(wèn)題時(shí)需要快速把每臺(tái)機(jī)器的日志抓回來(lái)分析。所以在這個(gè)工具的V2版本里我會(huì)把重點(diǎn)放在定時(shí)自動(dòng)下載和下載后自動(dòng)整理目錄這兩個(gè)功能上。寫(xiě)代碼最重要的是先確定鏈路連接、登錄、列目錄、傳輸每一步都有對(duì)應(yīng)的信號(hào)處理。QFtp可以讓你不需要絞盡腦汁去實(shí)現(xiàn)協(xié)議細(xì)節(jié)但協(xié)議層面的坑還是要親身踩一遍才能記住。分享這些主要是幫后面的人少走彎路。如果你也在搗鼓類似的Qt FTP工具遇到具體問(wèn)題歡迎交流。本文還有配套的精品資源點(diǎn)擊獲取