bilibili-downloader異步并發(fā)下載深度解析asyncio與信號量如何高效控制批量下載不翻車【免費下載鏈接】bilibili-downloaderB站視頻下載支持下載大會員清晰度4K持續(xù)更新中項目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloaderbilibili-downloader 是一款 B站視頻下載器支持大會員 4K 高清晰度、批量下載與分P視頻。它的核心賣點之一就是基于 asyncio 的異步并發(fā)下載——通過信號量Semaphore精準控制并發(fā)數(shù)量讓同時下載多個視頻時既快又不翻車。這篇文章帶你輕松讀懂它背后的并發(fā)設(shè)計。為什么批量下載容易翻車批量下載視頻時新手最常遇到兩類問題全速并發(fā) → 被限流一口氣發(fā)起幾十個請求帶寬被瓜分每個都變慢甚至觸發(fā)超時、連接被拒串行下載 → 太慢一個下載完再下一個10 個 1080P 視頻要等幾個小時。bilibili-downloader 的解法是有限并發(fā)讓固定數(shù)量的下載任務(wù)同時跑某個任務(wù)完成后再補一個新的進來兼顧速度與穩(wěn)定。三層并發(fā)架構(gòu)總覽整個下載流程分布在幾個核心模塊中職責(zé)清晰模塊職責(zé)main.py調(diào)度入口創(chuàng)建并發(fā)任務(wù)、控制并發(fā)數(shù)、輸出下載摘要strategy/bilibili_executor.py抓取視頻信息、執(zhí)行下載、合并音視頻strategy/default.py普通視頻BV號解析策略strategy/bangumi.py番劇/電影解析策略models/video.py視頻數(shù)據(jù)模型與清晰度映射config.pyCookie、待下載 URL 列表、輸出目錄配置并發(fā)控制分為三層層層設(shè)防批量級Semaphore 限制同時下載的視頻數(shù)默認 2 └── 視頻級每個視頻的音頻視頻流并行下載asyncio.gather └── 文件級斷點續(xù)傳 失敗自動重試最多 5 次信號量Semaphore并發(fā)控制的核心打開 main.py核心邏輯只有短短幾行semaphore asyncio.Semaphore(max_concurrent) # 默認 2 async def download_with_limit(url): async with semaphore: await self.download_single(url) tasks [download_with_limit(url) for url in urls] await asyncio.gather(*tasks)用一句通俗的話解釋信號量就像停車場入口的閘機。asyncio.Semaphore(2)表示最多只有 2 個車位所有下載任務(wù)先排隊拿到車位才能開始誰下載完誰歸還空出的車位立刻給下一個任務(wù)。這樣做的好處速度可控帶寬集中在少數(shù)任務(wù)上每個視頻都能跑滿網(wǎng)速永不超時不會因請求過密觸發(fā) B 站限流或連接超時動態(tài)補位任務(wù)完成即補新任務(wù)全程無空窗期。max_concurrent在 main.py 中默認為 2網(wǎng)絡(luò)好可以調(diào)高到 3~4網(wǎng)絡(luò)差建議保持 2。鎖Lock讓共享資源井井有條多任務(wù)同時跑共享數(shù)據(jù)就容易出現(xiàn)競爭條件。項目用三把 asyncio 鎖精準保護_lockmain.py保護成功/失敗視頻列表的寫入保證摘要統(tǒng)計不串行錯亂_counter_lockstrategy/bilibili_executor.py保護視頻編號計數(shù)器確保每個任務(wù)拿到的編號唯一不重復(fù)_print_lockstrategy/bilibili_executor.py保護終端輸出多個任務(wù)的打印不會互相穿插成亂碼。 小提示asyncio 的鎖是異步鎖等待期間事件循環(huán)可以繼續(xù)調(diào)度其他任務(wù)不會像傳統(tǒng)線程鎖那樣把整個程序卡死。音視頻并行單視頻內(nèi)的第二層并發(fā)B 站高清晰度視頻采用 DASH 格式音頻和視頻是兩條獨立的流。在 strategy/bilibili_executor.py 中項目用一個asyncio.gather讓兩路同時下載 視頻流可能高達 4K 音頻流通常更小、更快兩者并行完成后才判定該視頻下載成功隨后由 strategy/bilibili_executor.py 中的VideoMerge調(diào)用 ffmpeg 無損合并-c copy不重新編碼速度極快。若系統(tǒng)沒有 ffmpeg會自動回退到 moviepy 方案。斷點續(xù)傳 自動重試單文件級的保險絲即使并發(fā)控制得再好網(wǎng)絡(luò)抖動仍可能發(fā)生。strategy/bilibili_executor.py 中的_download方法為每個文件再加了雙保險自動重試捕獲網(wǎng)絡(luò)錯誤后最多重試 5 次每次間隔 5 秒斷點續(xù)傳每次請求都帶上Range: bytes已下載字節(jié)-請求頭中斷后從斷點繼續(xù)已下載的幾 GB 不會白費進度可見基于 tqdm 的實時進度條多任務(wù)進度互不干擾?？焖偕鲜秩酵瓿膳?4K 下載第 1 步安裝依賴pip3 install -r requirements.txt依賴清單見 requirements.txt核心是 httpx異步 HTTP 客戶端、beautifulsoup4頁面解析、tqdm進度條。第 2 步配置 Cookie約 30 天更新一次登錄 B 站后按F12打開開發(fā)者工具 → 網(wǎng)絡(luò)Network→ 刷新頁面 → 點擊第一個請求在 Request Headers 的 cookie 中找到SESSDATA完整復(fù)制 cookie 值粘貼到 config.py 的COOKIE變量中第 3 步添加視頻 URL 并運行在 config.py 的URL列表中粘貼要下載的視頻地址支持分P參數(shù)?p2然后執(zhí)行python main.py運行結(jié)束后會輸出下載摘要成功/失敗數(shù)量、總用時。若有失敗的視頻項目會自動把它們的 URL 導(dǎo)出到failed_urls.txt直接復(fù)制回URL列表重試即可無需手動記錄。下載失敗先檢查這三處現(xiàn)象常見原因解決辦法清晰度只有 480PCookie 過期或 URL 被重定向更換 Cookie檢查 URL 中/BV號后是否有斜杠項目會自動規(guī)范化見 strategy/bilibili_executor.py反復(fù)超時并發(fā)數(shù)過高或網(wǎng)絡(luò)不穩(wěn)調(diào)低max_concurrent斷點續(xù)傳會自動續(xù)上提示地區(qū)限制番劇版權(quán)限制換無地區(qū)限制的片源或檢查網(wǎng)絡(luò)出口清晰度的完整映射8K → 360P定義在 models/video.py其中 126 對應(yīng)杜比視界 4K、120 對應(yīng)超清 4K。總結(jié)并發(fā)不翻車的三個設(shè)計要點信號量限流asyncio.Semaphore把并發(fā)數(shù)鎖在固定值速度與穩(wěn)定兼得多層鎖保護列表、計數(shù)器、輸出各加一把異步鎖共享數(shù)據(jù)零競爭失敗自愈斷點續(xù)傳 5 次重試 失敗 URL 自動導(dǎo)出任何單次抖動都不會毀掉整批任務(wù)。這套批量級信號量 視頻級 gather 文件級重試的三層并發(fā)模型不只適用于 B 站下載也是所有批量 IO 任務(wù)文件同步、數(shù)據(jù)抓取都值得參考的通用模式。【免費下載鏈接】bilibili-downloaderB站視頻下載支持下載大會員清晰度4K持續(xù)更新中項目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考