、字幕、批量操作全攻略)
做技術(shù)這些年身邊朋友問得最多的除了剪輯思路就是B站這個視頻到底怎么下載 平臺本身不提供離線緩存而且不少優(yōu)質(zhì)內(nèi)容會因為版權(quán)、UP主刪稿或平臺下架再也找不到。我自己長期用一款開源工具搞定這件事不僅是下載連畫質(zhì)選擇、字幕抓取、批量處理都能一并解決。這篇就是圍繞它的一份完整實操記錄。先說一句很多人在搜索引擎里找B站視頻下載神器結(jié)果彈出的全是導流網(wǎng)站、捆綁下載器甚至還需要充值會員。真正好用的反而是命令行開源工具免費、無廣告、不鎖定格式而且一次學會能用在幾十個視頻平臺的資源保存上。我用的是 yt-dlp一個從 youtube-dl 分叉出來的開源下載器因為社區(qū)活躍、更新頻繁對 B站 的兼容性在同類里屬于第一梯隊。1. 這個開源工具到底能解決什么問題1.1 為什么不用在線解析網(wǎng)站和第三方客戶端市面上主流的B站視頻保存方式不外乎三類在線解析站、整合型下載App、瀏覽器插件。這三類我都試過一輪說說真實的體驗。在線解析站用起來確實簡單粘貼鏈接點一下就能出結(jié)果但問題也很明顯。首先是清晰度受限很多解析站最高只能輸出1080pB站的高碼率、杜比視界、8K這些規(guī)格基本拿不到。其次是穩(wěn)定性差域名隔三差五就要換一個收藏夾里的解析站經(jīng)常打不開等你再找一個新站舊站里保存的鏈接索引又斷了。最關(guān)鍵的還是隱私和安全性這類站點往往塞滿了彈窗廣告有些還會在你下載時捆綁不明程序我見過不止一臺電腦因為裝這類工具全家桶而中招。第三方下載App的問題在于平臺兼容性。不少App宣稱支持B站但B站的網(wǎng)頁結(jié)構(gòu)和接口一調(diào)整這些App就集體失靈等開發(fā)者更新往往要好幾周。而且部分App在解析過程中會把視頻和音頻分開下載最后合并時強制你安裝它的私有解碼器本質(zhì)上還是把你圈在它的生態(tài)里。瀏覽器插件是中等偏上的選擇勝在輕量點一下按鈕就能捕獲當前頁面的視頻流。問題是插件只能應(yīng)對Web端頁面能直接加載的清晰度想要1080P高碼率、60幀或者4K必須在瀏覽器里切換對應(yīng)播放清晰度插件才能抓到高畫質(zhì)源體驗比較被動。如果UP主設(shè)置了不允許下載插件也無能為力。1.2 為什么是 yt-dlp 而不是其他開源方案開源視頻下載領(lǐng)域其實有不少選擇比如 you-get、BBDown、Annie還有最老牌的 youtube-dl。我為什么最終鎖定了 yt-dlp這里有三個原因更快的更新節(jié)奏。youtube-dl 雖然是祖師爺?shù)滤俣仍诮鼉赡昝黠@慢了下來。B站這類站點經(jīng)常調(diào)整接口參數(shù)下載器不更新就會失效。yt-dlp 的分叉團隊把社區(qū)合并請求的處理速度拉快了很多基本做到了B站一改版、兩三天內(nèi)就出補丁的節(jié)奏。更完善的B站專用參數(shù)。yt-dlp 針對B站做了非常多定制化的支持。比如能識別B站的投稿ID、分P信息、互動視頻結(jié)構(gòu)還能直接下載CC字幕、AI字幕、彈幕文件。這些能力在通用下載器里不一定都有但做內(nèi)容存檔的人恰恰最需要這些輔助文件?；钴S的社區(qū)配套。找資料、查報錯都方便。哪怕真的遇到問題GitHub的issue區(qū)里往往已經(jīng)有人給出了同場景的解決方案。這對于命令行接受度一般的新手來說是很大的信心保障。此外配置項極其豐富也是它的一大優(yōu)勢。輸出文件名模板、下載速度限制、格式排序、章節(jié)拆分、嵌入元數(shù)據(jù)和縮略圖全部都能通過參數(shù)定制。它本質(zhì)上不只是一個下載器而是一套完整的媒體資產(chǎn)歸檔工具鏈。2. 環(huán)境準備與快速上手2.1 安裝依賴Python 與 FFmpegyt-dlp 本質(zhì)上是一個 Python 包安裝之前首先要確保電腦上有可用的 Python 環(huán)境。這里有一個常見的坑很多Windows用戶裝了Python但沒有勾選Add Python to PATH選項導致后續(xù)執(zhí)行命令時系統(tǒng)提示找不到命令。安裝Python時建議直接把Add Python to PATH勾上裝完后在命令行里輸入python --version驗證一下。Linux/macOS用戶一般自帶Python3直接執(zhí)行后續(xù)命令即可。除了 Python還需要 FFmpeg。FFmpeg 是處理音視頻的核心引擎yt-dlp 負責把視頻流和音頻流分別下載之后調(diào)用 FFmpeg 把兩者合成一個文件。如果缺了 FFmpeg下載下來的文件很可能只有畫面沒有聲音或者根本合并不了。FFmpeg 的安裝方式按平臺分# Windows用 winget 或去官網(wǎng)下載解壓后配置環(huán)境變量 winget install ffmpeg # macOS使用 Homebrew brew install ffmpeg # Debian/Ubuntu sudo apt update sudo apt install ffmpeg # CentOS/RHEL sudo yum install ffmpeg裝好之后在終端里輸入ffmpeg -version能看到版本號就說明環(huán)境正常。這里多說一句FFmpeg盡量安裝最新的release版老版本在解碼某些新格式音頻比如B站的杜比全景聲時可能力不從心。2.2 基礎(chǔ)下載命令一條命令拉回完整視頻環(huán)境就緒后安裝 yt-dlp 就非常簡單了pip install -U yt-dlp-U參數(shù)表示升級到最新版。如果你的系統(tǒng)里同時存在 Python2 和 Python3可能需要用pip3來安裝。安裝完成后下載B站視頻最基礎(chǔ)的命令是yt-dlp 目標視頻鏈接把目標視頻鏈接換成B站視頻URL回車執(zhí)行工具會自動解析網(wǎng)頁、獲取視頻信息并選擇最高可用的畫質(zhì)進行下載。整個流程是全自動的無需人工干預(yù)。第一次執(zhí)行時終端會滾動顯示解析日志包括視頻標題、時長、可用格式、下載進度和合并狀態(tài)。如果你下載的是分P視頻合集比如課程、番劇、多章節(jié)影視解說上面的命令會把所有分P全部下載如果只想保存某幾P使用--playlist-start和--playlist-end指定起止序號yt-dlp --playlist-start 3 --playlist-end 5 合集鏈接這條命令的意思是只下載第3P到第5P避免把整個幾百P的合集全部拖下來占用硬盤空間。2.3 查看可用格式先看清再下手直接下載雖然方便但有時候我們需要知道目標視頻到底有哪些清晰度可選。執(zhí)行yt-dlp -F 目標視頻鏈接這里-F的全稱是--list-formats會以表格形式列出該視頻所有可用格式。B站的視頻流通常被分為視頻軌和音頻軌視頻軌有id、分辨率、幀率、編碼格式信息音頻軌有比特率信息。表格末尾還有一個推薦組合項就是工具按照你的配置偏好選出的最佳組合。這一步很重要因為B站某些視頻的高畫質(zhì)格式編碼可能是AV1而舊設(shè)備不支持硬解播放會卡頓。通過-F看一眼編碼格式心里有底再決定下載哪個版本。這一點強烈建議養(yǎng)成習慣不管下載哪個平臺的內(nèi)容先-F再下載能避免很多后續(xù)播放兼容性問題。3. 核心參數(shù)與進階玩法3.1 按需定制輸出格式畫質(zhì)和體積的平衡術(shù)默認情況下yt-dlp會自動選擇最大文件。但在實際使用中最大并不總是最好的選擇。舉個例子一個4K航拍視頻如果編碼是AV1視頻碼率會壓縮得很低畫質(zhì)感知并不比同源的1080p高碼率強多少文件體積卻大了數(shù)倍。想精細控制格式選擇可以直接指定格式ID前提是先用-F查出需要的格式y(tǒng)t-dlp -f bv*[height1080]ba/b[height1080] 目標視頻鏈接這個命令中的表達式拆開看bv*表示最佳視頻流ba表示最佳音頻流[height1080]是過濾條件只選分辨率為1080p或更低的視頻軌組合音頻軌最后的/b[height1080]是回退選項如果找不到符合條件的最佳組合就退化到普通格式。這種寫法可以讓你在保證畫質(zhì)的基礎(chǔ)上控制存儲占用。如果你想要最終的 mp4 容器格式再加一個重封裝參數(shù)yt-dlp -f bv*[extmp4]ba[extm4a]/b[extmp4] --merge-output-format mp4 目標視頻鏈接這個配置會優(yōu)先找mp4封裝的視頻軌和m4a封裝的音頻軌合并產(chǎn)物也是mp4通用性最強導入剪輯軟件基本不會出幺蛾子。3.2 字幕、彈幕與封面一次下載全部歸檔看B站視頻字幕和彈幕有時候比畫面本身還重要。對做二創(chuàng)的人而言字幕文件可以直接作為剪輯時的文本參考彈幕則是了解觀眾反饋、捕捉熱梗的一手素材。yt-dlp 下載字幕的命令是yt-dlp --write-subs --write-auto-subs --sub-langs zh-hans,zh-cn 目標視頻鏈接--write-subs下載UP主上傳的CC字幕--write-auto-subs抓取B站的AI語音識別字幕--sub-langs指定字幕語言。下載后文件夾里除了視頻文件還會有.srt或.vtt格式的字幕文件。用字幕文件導入剪輯軟件做文字排版效率比手打高得多。彈幕的抓取需要單獨依賴工具但yt-dlp也提供了對應(yīng)的寫入?yún)?shù)把彈幕保存為.xml或.ass格式。支持彈幕的播放器如彈彈play、PotPlayer配合插件加載后能直接看到當年的彈幕氛圍。常用參數(shù)yt-dlp --write-comments --write-info-json 目標視頻鏈接--write-info-json會把視頻的基礎(chǔ)信息標題、UP主、發(fā)布時間、簡介、標簽等保存為一個結(jié)構(gòu)化JSON文件這在批量歸檔素材時非常有用。配合腳本做數(shù)據(jù)管理可以直接把JSON導入表格生成自己的視頻庫索引。3.3 批量下載與定時任務(wù)搭建個人收藏庫當收藏夾里的視頻數(shù)量多起來之后一條條手動跑命令就太原始了。把鏈接批量保存到文本文件一行一個命令行直接調(diào)用yt-dlp -a 收藏夾鏈接列表.txt -o %(playlist_title)s/%(title)s.%(ext)s-a參數(shù)指向鏈接列表文件-o參數(shù)自定義輸出路徑。上面的命名模板表示把每個視頻存放到以播放列表標題命名的目錄里文件名是視頻標題。這樣下載完的自然分類效果比下載幾百個文件堆在一起要好得多。想實現(xiàn)定時全量備份在Linux/macOS上用 crontabWindows上用計劃任務(wù)。比如每周日凌晨3點執(zhí)行一條腳本把收藏夾所有鏈接拉一遍最新版本0 3 * * 0 cd /path/to/download yt-dlp -a 收藏夾鏈接列表.txt -o %(title)s.%(ext)s因為yt-dlp在目標文件已存在時默認會跳過所以同一份鏈接列表反復執(zhí)行并不會有重復下載只有真正新增或更新的視頻才會被拉下來適合長期跟蹤某些UP主的選題變化。4. 下載之后的視頻編輯加工4.1 用 FFmpeg 快速截取精華片段下載到本地后很多人的下一步是剪出短視頻、截取某個鏡頭、或者把長視頻砍成多個知識點。這時候 FFmpeg 就派上用場了。我經(jīng)常用的無損截取命令是這樣ffmpeg -ss 00:01:30 -t 00:00:20 -i 原視頻.mp4 -c copy 截取片段.mp4這個命令的含義-ss指定從第1分30秒開始-t指定截取20秒時長-c copy表示直接復制音視頻流不重新編碼。這樣執(zhí)行速度極快而且畫質(zhì)0損失。但要注意一點當原視頻的關(guān)鍵幀間隔和剪切點不完全對齊時-c copy可能導致截取片段開頭有幾幀黑場或者花屏。如果你要交出去的內(nèi)容不允許有任何瑕疵改成重新編碼的方式更穩(wěn)ffmpeg -ss 00:01:30 -t 00:00:20 -i 原視頻.mp4 -c:v libx264 -c:a aac 截取片段.mp4代價是耗時長一些但每一幀都干凈。4.2 提取音頻做素材庫把視頻里的BGM、人聲、環(huán)境音提取出來是很多剪輯師的日常需求。FFmpeg 提取音頻為 mp3ffmpeg -i 原視頻.mp4 -vn -c:a libmp3lame -q:a 2 音頻文件.mp3-q:a 2是 mp3 編碼質(zhì)量參數(shù)數(shù)值越小質(zhì)量越高體積越大2 屬于聽覺無損級別。但如果原視頻本身是高質(zhì)量音頻流比如B站的高碼率音軌我更建議保留無損格式ffmpeg -i 原視頻.mp4 -vn -c:a flac 音頻文件.flacFLAC格式體積大但作為素材庫原始檔完全值得后續(xù)想轉(zhuǎn)成任何格式都是有損轉(zhuǎn)損源頭保真最重要。4.3 一鍵成片開源剪輯工具的組合方案剪映、PR、Final Cut 當然很好用但如果你想走一條完全免費且可腳本化的路線開源世界的組合拳也很成熟。最常見的方案是FFmpeg Shotcut。Shotcut 是一款免費開源的跨平臺視頻編輯器支持多軌剪輯、濾鏡、關(guān)鍵幀動畫、導出代理功能覆蓋大多數(shù)短視頻創(chuàng)作需求。它導入yt-dlp 下載的mp4/mkv格式都能流暢編輯導出時也能調(diào)用FFmpeg引擎輸出H.264/H.265編碼算是閉環(huán)鏈路。更進階的玩法是用Python moviepy做自動化處理。比如批量給一批視頻加統(tǒng)一的開頭標題、統(tǒng)一的片尾LOGO或者在每個視頻中段插入一條固定音量漸變的轉(zhuǎn)場提示。這類重復性勞動手剪容易厭倦寫成腳本反而一勞永逸from moviepy.editor import VideoFileClip, TextClip, CompositeVideoClip # 批量給視頻加標題 video VideoFileClip(input.mp4) txt TextClip(My Favorite Scene, fontsize70, colorwhite, duration3) result CompositeVideoClip([video, txt.set_position((center, 100)).set_duration(3)]) result.write_videofile(output.mp4, codeclibx264)把這段邏輯包在for循環(huán)里一次跑一百個視頻都行。這種下載 剪輯鏈路實現(xiàn)了從保存到加工的完整閉環(huán)。5. 常見問題與排查技巧實錄5.1 解析失敗或者提示暫不支持用yt-dlp拉B站鏈接偶爾會遇到解析失敗、返回錯誤碼、或者提示Video unavailable。出現(xiàn)這種情況九成原因是B站接口調(diào)整后本地安裝的yt-dlp版本過舊下載器沒有跟上網(wǎng)站變化。解決方案就是升級pip install -U yt-dlp如果升級后仍然失敗考慮B站的地區(qū)限制或登錄狀態(tài)要求。部分視頻尤其是番劇、電影、紀錄片只對登錄用戶開放下載。此時需要為yt-dlp提供登錄信息yt-dlp --cookies-from-browser edge 目標視頻鏈接--cookies-from-browser會直接從你本地的瀏覽器讀取登錄態(tài)Cookie支持chrome、edge、firefox、opera等讓yt-dlp以你的賬號身份去訪問視頻源。這樣番劇、會員專屬內(nèi)容都能正常解析。注意這是個較為敏感的操作只在你要合法保存?zhèn)€人可訪問內(nèi)容時使用。5.2 下載速度慢、顯示限流B站對非登錄用戶的視頻流請求會做限速和風控。解決思路有兩個維度。第一盡量使用Cookie登錄態(tài)請求登錄態(tài)的請求優(yōu)先級明顯高于匿名請求速度會有直觀提升。第二合理設(shè)置并發(fā)數(shù)yt-dlp -N 4 目標視頻鏈接-N參數(shù)控制同時下載的分片數(shù)提高并發(fā)可以有效對抗B站默認的流式分片限速。但并發(fā)值不是越大越好太高的并發(fā)可能觸發(fā)風控反而降速我自己測試下來4-6是穩(wěn)定區(qū)間。如果B站把你的IP臨時限制了別急著換IP過幾分鐘再試往往就能恢復。千萬不要同一時間并發(fā)大量的下載任務(wù)容易被拉黑列表。5.3 文件下載完成但沒有聲音或無法播放這是最常見的翻車場景。原因有幾種第一是FFmpeg沒有正確安裝或沒有加入PATH。yt-dlp在合并音視頻時找不到FFmpeg就會放棄合并最后留下一個.webm或.m4a音頻文件和一個無聲音的視頻文件。檢查FFmpeg是否可用最簡單的方式就是執(zhí)行ffmpeg -version。第二是封裝格式不兼容。比如B站某些視頻的音頻軌是opus編碼如果強制合并成mp4容器舊設(shè)備會無法解碼播放。解決方法是改用mkv容器或用參數(shù)指定音頻重新編碼yt-dlp -f bv*ba/b --recode-video mp4 目標視頻鏈接--recode-video mp4會在合并完成后重新編碼成mp4容器兼容性最好代價是耗時變長一些。第三是下載的編碼格式超出本地播放器解碼能力。B站現(xiàn)在有AV1、HEVC、AVC三種視頻編碼方案。如果你的設(shè)備播放器較舊AV1解碼會卡頓甚至黑屏。下載前用-F看一眼格式ID優(yōu)先選avc或h264編碼的版本。5.4 誤刪文件后的補救策略下載的東西多了難免有手滑刪錯的時候。如果視頻文件已經(jīng)被刪但對應(yīng)的*.info.json還在yt-dlp 提供了一個從元數(shù)據(jù)恢復下載的技巧yt-dlp --load-info-json xxxx.info.json 視頻鏈接這個操作會讀取舊的JSON文件中的視頻元數(shù)據(jù)重新發(fā)起下載并且輸出文件名與原文件一致方便恢復到原有目錄結(jié)構(gòu)。當然這個方法依賴鏈接仍然有效如果源視頻已被UP主刪除就只能靠本地有沒有做過其他備份了。所以我現(xiàn)在養(yǎng)成了一個習慣重要的素材不僅存本地還會在網(wǎng)盤或移動硬盤再放一份。特別是做二創(chuàng)的素材原視頻一旦在B站下架本地就是唯一來源了只有零備份才是真的丟失。5.5 不同平臺播放入庫的統(tǒng)一方案下載后如果要在不同設(shè)備間互傳播放建議保持一個統(tǒng)一規(guī)范能選1080p就選1080p容器最好固定為mp4編碼優(yōu)先H.264。這個組合在手機、電腦、電視盒子、投影儀上的兼容性最高基本不會因為編碼問題打不開。如果追求更高觀影體驗4KHDR的版本可以單獨建一個收藏原盤目錄不跟日常播放庫混在一起。批量統(tǒng)一轉(zhuǎn)碼的命令也不難for f in *.mkv; do ffmpeg -i $f -c:v libx264 -c:a aac ${f%.mkv}.mp4; done這套方法適合整理大型收藏的時統(tǒng)一格式缺點是耗時我會放在睡覺前跑一整晚。別忘了下載和轉(zhuǎn)碼都是CPU/GPU密集任務(wù)筆記本注意散熱。6. 合規(guī)使用與個人經(jīng)驗分享關(guān)于下載B站視頻我一直堅持三個原則。第一只下載自己有權(quán)訪問的內(nèi)容主要用于個人學習、資料備份與二次創(chuàng)作第二如果涉及發(fā)布、傳播嚴格遵守原作者聲明和平臺規(guī)則分享時注明出處、標注原作者第三不用下載能力去批量搬運他人原創(chuàng)內(nèi)容那既是對創(chuàng)作者的不尊重也可能給自己帶來版權(quán)糾紛。開源工具放大的是個人的創(chuàng)作自由度不是搬運的工具箱。我個人在實際操作中的最大體會是yt-dlp 真正的價值不在下載這個動作本身而在于把你從平臺的內(nèi)容圍欄中解放出來。你可以自主控制素材的清晰度、封裝、字幕、命名規(guī)則甚至把整個下載流程接入自己的自動化腳本。這套工作流一旦搭建好之后每一次收藏視頻花費的時間基本就是個位數(shù)秒。再分享一個進階思路如果你把下載后的視頻、信息JSON、封面圖全部按照固定規(guī)則歸檔還能結(jié)合一些開源媒體管理工具搭建私人影音庫。比如把yt-dlp的輸出目錄指向Jellyfin的媒體庫B站下載的視頻自動出現(xiàn)在家庭影院里電視上直接觀看。這種下載-歸檔-管理的三級結(jié)構(gòu)才是這套工具的完全體用法。工具在更新平臺會改版但這套以開源工具為核心的個人收藏體系的方法是穩(wěn)定的。希望這篇記錄能給同樣喜歡存視頻的朋友一點參考。如果你在自己操作中遇到了什么新報錯或者有趣的折騰思路歡迎在評論區(qū)聊聊我盡量把對應(yīng)的問題更新到后面的經(jīng)驗補充里。 用yt-dlp開源工具下載B站視頻：畫質(zhì)、字幕、批量操作全攻略
做技術(shù)這些年身邊朋友問得最多的除了剪輯思路就是B站這個視頻到底怎么下載 平臺本身不提供離線緩存而且不少優(yōu)質(zhì)內(nèi)容會因為版權(quán)、UP主刪稿或平臺下架再也找不到。我自己長期用一款開源工具搞定這件事不僅是下載連畫質(zhì)選擇、字幕抓取、批量處理都能一并解決。這篇就是圍繞它的一份完整實操記錄。先說一句很多人在搜索引擎里找B站視頻下載神器結(jié)果彈出的全是導流網(wǎng)站、捆綁下載器甚至還需要充值會員。真正好用的反而是命令行開源工具免費、無廣告、不鎖定格式而且一次學會能用在幾十個視頻平臺的資源保存上。我用的是 yt-dlp一個從 youtube-dl 分叉出來的開源下載器因為社區(qū)活躍、更新頻繁對 B站 的兼容性在同類里屬于第一梯隊。1. 這個開源工具到底能解決什么問題1.1 為什么不用在線解析網(wǎng)站和第三方客戶端市面上主流的B站視頻保存方式不外乎三類在線解析站、整合型下載App、瀏覽器插件。這三類我都試過一輪說說真實的體驗。在線解析站用起來確實簡單粘貼鏈接點一下就能出結(jié)果但問題也很明顯。首先是清晰度受限很多解析站最高只能輸出1080pB站的高碼率、杜比視界、8K這些規(guī)格基本拿不到。其次是穩(wěn)定性差域名隔三差五就要換一個收藏夾里的解析站經(jīng)常打不開等你再找一個新站舊站里保存的鏈接索引又斷了。最關(guān)鍵的還是隱私和安全性這類站點往往塞滿了彈窗廣告有些還會在你下載時捆綁不明程序我見過不止一臺電腦因為裝這類工具全家桶而中招。第三方下載App的問題在于平臺兼容性。不少App宣稱支持B站但B站的網(wǎng)頁結(jié)構(gòu)和接口一調(diào)整這些App就集體失靈等開發(fā)者更新往往要好幾周。而且部分App在解析過程中會把視頻和音頻分開下載最后合并時強制你安裝它的私有解碼器本質(zhì)上還是把你圈在它的生態(tài)里。瀏覽器插件是中等偏上的選擇勝在輕量點一下按鈕就能捕獲當前頁面的視頻流。問題是插件只能應(yīng)對Web端頁面能直接加載的清晰度想要1080P高碼率、60幀或者4K必須在瀏覽器里切換對應(yīng)播放清晰度插件才能抓到高畫質(zhì)源體驗比較被動。如果UP主設(shè)置了不允許下載插件也無能為力。1.2 為什么是 yt-dlp 而不是其他開源方案開源視頻下載領(lǐng)域其實有不少選擇比如 you-get、BBDown、Annie還有最老牌的 youtube-dl。我為什么最終鎖定了 yt-dlp這里有三個原因更快的更新節(jié)奏。youtube-dl 雖然是祖師爺?shù)滤俣仍诮鼉赡昝黠@慢了下來。B站這類站點經(jīng)常調(diào)整接口參數(shù)下載器不更新就會失效。yt-dlp 的分叉團隊把社區(qū)合并請求的處理速度拉快了很多基本做到了B站一改版、兩三天內(nèi)就出補丁的節(jié)奏。更完善的B站專用參數(shù)。yt-dlp 針對B站做了非常多定制化的支持。比如能識別B站的投稿ID、分P信息、互動視頻結(jié)構(gòu)還能直接下載CC字幕、AI字幕、彈幕文件。這些能力在通用下載器里不一定都有但做內(nèi)容存檔的人恰恰最需要這些輔助文件?；钴S的社區(qū)配套。找資料、查報錯都方便。哪怕真的遇到問題GitHub的issue區(qū)里往往已經(jīng)有人給出了同場景的解決方案。這對于命令行接受度一般的新手來說是很大的信心保障。此外配置項極其豐富也是它的一大優(yōu)勢。輸出文件名模板、下載速度限制、格式排序、章節(jié)拆分、嵌入元數(shù)據(jù)和縮略圖全部都能通過參數(shù)定制。它本質(zhì)上不只是一個下載器而是一套完整的媒體資產(chǎn)歸檔工具鏈。2. 環(huán)境準備與快速上手2.1 安裝依賴Python 與 FFmpegyt-dlp 本質(zhì)上是一個 Python 包安裝之前首先要確保電腦上有可用的 Python 環(huán)境。這里有一個常見的坑很多Windows用戶裝了Python但沒有勾選Add Python to PATH選項導致后續(xù)執(zhí)行命令時系統(tǒng)提示找不到命令。安裝Python時建議直接把Add Python to PATH勾上裝完后在命令行里輸入python --version驗證一下。Linux/macOS用戶一般自帶Python3直接執(zhí)行后續(xù)命令即可。除了 Python還需要 FFmpeg。FFmpeg 是處理音視頻的核心引擎yt-dlp 負責把視頻流和音頻流分別下載之后調(diào)用 FFmpeg 把兩者合成一個文件。如果缺了 FFmpeg下載下來的文件很可能只有畫面沒有聲音或者根本合并不了。FFmpeg 的安裝方式按平臺分# Windows用 winget 或去官網(wǎng)下載解壓后配置環(huán)境變量 winget install ffmpeg # macOS使用 Homebrew brew install ffmpeg # Debian/Ubuntu sudo apt update sudo apt install ffmpeg # CentOS/RHEL sudo yum install ffmpeg裝好之后在終端里輸入ffmpeg -version能看到版本號就說明環(huán)境正常。這里多說一句FFmpeg盡量安裝最新的release版老版本在解碼某些新格式音頻比如B站的杜比全景聲時可能力不從心。2.2 基礎(chǔ)下載命令一條命令拉回完整視頻環(huán)境就緒后安裝 yt-dlp 就非常簡單了pip install -U yt-dlp-U參數(shù)表示升級到最新版。如果你的系統(tǒng)里同時存在 Python2 和 Python3可能需要用pip3來安裝。安裝完成后下載B站視頻最基礎(chǔ)的命令是yt-dlp 目標視頻鏈接把目標視頻鏈接換成B站視頻URL回車執(zhí)行工具會自動解析網(wǎng)頁、獲取視頻信息并選擇最高可用的畫質(zhì)進行下載。整個流程是全自動的無需人工干預(yù)。第一次執(zhí)行時終端會滾動顯示解析日志包括視頻標題、時長、可用格式、下載進度和合并狀態(tài)。如果你下載的是分P視頻合集比如課程、番劇、多章節(jié)影視解說上面的命令會把所有分P全部下載如果只想保存某幾P使用--playlist-start和--playlist-end指定起止序號yt-dlp --playlist-start 3 --playlist-end 5 合集鏈接這條命令的意思是只下載第3P到第5P避免把整個幾百P的合集全部拖下來占用硬盤空間。2.3 查看可用格式先看清再下手直接下載雖然方便但有時候我們需要知道目標視頻到底有哪些清晰度可選。執(zhí)行yt-dlp -F 目標視頻鏈接這里-F的全稱是--list-formats會以表格形式列出該視頻所有可用格式。B站的視頻流通常被分為視頻軌和音頻軌視頻軌有id、分辨率、幀率、編碼格式信息音頻軌有比特率信息。表格末尾還有一個推薦組合項就是工具按照你的配置偏好選出的最佳組合。這一步很重要因為B站某些視頻的高畫質(zhì)格式編碼可能是AV1而舊設(shè)備不支持硬解播放會卡頓。通過-F看一眼編碼格式心里有底再決定下載哪個版本。這一點強烈建議養(yǎng)成習慣不管下載哪個平臺的內(nèi)容先-F再下載能避免很多后續(xù)播放兼容性問題。3. 核心參數(shù)與進階玩法3.1 按需定制輸出格式畫質(zhì)和體積的平衡術(shù)默認情況下yt-dlp會自動選擇最大文件。但在實際使用中最大并不總是最好的選擇。舉個例子一個4K航拍視頻如果編碼是AV1視頻碼率會壓縮得很低畫質(zhì)感知并不比同源的1080p高碼率強多少文件體積卻大了數(shù)倍。想精細控制格式選擇可以直接指定格式ID前提是先用-F查出需要的格式y(tǒng)t-dlp -f bv*[height1080]ba/b[height1080] 目標視頻鏈接這個命令中的表達式拆開看bv*表示最佳視頻流ba表示最佳音頻流[height1080]是過濾條件只選分辨率為1080p或更低的視頻軌組合音頻軌最后的/b[height1080]是回退選項如果找不到符合條件的最佳組合就退化到普通格式。這種寫法可以讓你在保證畫質(zhì)的基礎(chǔ)上控制存儲占用。如果你想要最終的 mp4 容器格式再加一個重封裝參數(shù)yt-dlp -f bv*[extmp4]ba[extm4a]/b[extmp4] --merge-output-format mp4 目標視頻鏈接這個配置會優(yōu)先找mp4封裝的視頻軌和m4a封裝的音頻軌合并產(chǎn)物也是mp4通用性最強導入剪輯軟件基本不會出幺蛾子。3.2 字幕、彈幕與封面一次下載全部歸檔看B站視頻字幕和彈幕有時候比畫面本身還重要。對做二創(chuàng)的人而言字幕文件可以直接作為剪輯時的文本參考彈幕則是了解觀眾反饋、捕捉熱梗的一手素材。yt-dlp 下載字幕的命令是yt-dlp --write-subs --write-auto-subs --sub-langs zh-hans,zh-cn 目標視頻鏈接--write-subs下載UP主上傳的CC字幕--write-auto-subs抓取B站的AI語音識別字幕--sub-langs指定字幕語言。下載后文件夾里除了視頻文件還會有.srt或.vtt格式的字幕文件。用字幕文件導入剪輯軟件做文字排版效率比手打高得多。彈幕的抓取需要單獨依賴工具但yt-dlp也提供了對應(yīng)的寫入?yún)?shù)把彈幕保存為.xml或.ass格式。支持彈幕的播放器如彈彈play、PotPlayer配合插件加載后能直接看到當年的彈幕氛圍。常用參數(shù)yt-dlp --write-comments --write-info-json 目標視頻鏈接--write-info-json會把視頻的基礎(chǔ)信息標題、UP主、發(fā)布時間、簡介、標簽等保存為一個結(jié)構(gòu)化JSON文件這在批量歸檔素材時非常有用。配合腳本做數(shù)據(jù)管理可以直接把JSON導入表格生成自己的視頻庫索引。3.3 批量下載與定時任務(wù)搭建個人收藏庫當收藏夾里的視頻數(shù)量多起來之后一條條手動跑命令就太原始了。把鏈接批量保存到文本文件一行一個命令行直接調(diào)用yt-dlp -a 收藏夾鏈接列表.txt -o %(playlist_title)s/%(title)s.%(ext)s-a參數(shù)指向鏈接列表文件-o參數(shù)自定義輸出路徑。上面的命名模板表示把每個視頻存放到以播放列表標題命名的目錄里文件名是視頻標題。這樣下載完的自然分類效果比下載幾百個文件堆在一起要好得多。想實現(xiàn)定時全量備份在Linux/macOS上用 crontabWindows上用計劃任務(wù)。比如每周日凌晨3點執(zhí)行一條腳本把收藏夾所有鏈接拉一遍最新版本0 3 * * 0 cd /path/to/download yt-dlp -a 收藏夾鏈接列表.txt -o %(title)s.%(ext)s因為yt-dlp在目標文件已存在時默認會跳過所以同一份鏈接列表反復執(zhí)行并不會有重復下載只有真正新增或更新的視頻才會被拉下來適合長期跟蹤某些UP主的選題變化。4. 下載之后的視頻編輯加工4.1 用 FFmpeg 快速截取精華片段下載到本地后很多人的下一步是剪出短視頻、截取某個鏡頭、或者把長視頻砍成多個知識點。這時候 FFmpeg 就派上用場了。我經(jīng)常用的無損截取命令是這樣ffmpeg -ss 00:01:30 -t 00:00:20 -i 原視頻.mp4 -c copy 截取片段.mp4這個命令的含義-ss指定從第1分30秒開始-t指定截取20秒時長-c copy表示直接復制音視頻流不重新編碼。這樣執(zhí)行速度極快而且畫質(zhì)0損失。但要注意一點當原視頻的關(guān)鍵幀間隔和剪切點不完全對齊時-c copy可能導致截取片段開頭有幾幀黑場或者花屏。如果你要交出去的內(nèi)容不允許有任何瑕疵改成重新編碼的方式更穩(wěn)ffmpeg -ss 00:01:30 -t 00:00:20 -i 原視頻.mp4 -c:v libx264 -c:a aac 截取片段.mp4代價是耗時長一些但每一幀都干凈。4.2 提取音頻做素材庫把視頻里的BGM、人聲、環(huán)境音提取出來是很多剪輯師的日常需求。FFmpeg 提取音頻為 mp3ffmpeg -i 原視頻.mp4 -vn -c:a libmp3lame -q:a 2 音頻文件.mp3-q:a 2是 mp3 編碼質(zhì)量參數(shù)數(shù)值越小質(zhì)量越高體積越大2 屬于聽覺無損級別。但如果原視頻本身是高質(zhì)量音頻流比如B站的高碼率音軌我更建議保留無損格式ffmpeg -i 原視頻.mp4 -vn -c:a flac 音頻文件.flacFLAC格式體積大但作為素材庫原始檔完全值得后續(xù)想轉(zhuǎn)成任何格式都是有損轉(zhuǎn)損源頭保真最重要。4.3 一鍵成片開源剪輯工具的組合方案剪映、PR、Final Cut 當然很好用但如果你想走一條完全免費且可腳本化的路線開源世界的組合拳也很成熟。最常見的方案是FFmpeg Shotcut。Shotcut 是一款免費開源的跨平臺視頻編輯器支持多軌剪輯、濾鏡、關(guān)鍵幀動畫、導出代理功能覆蓋大多數(shù)短視頻創(chuàng)作需求。它導入yt-dlp 下載的mp4/mkv格式都能流暢編輯導出時也能調(diào)用FFmpeg引擎輸出H.264/H.265編碼算是閉環(huán)鏈路。更進階的玩法是用Python moviepy做自動化處理。比如批量給一批視頻加統(tǒng)一的開頭標題、統(tǒng)一的片尾LOGO或者在每個視頻中段插入一條固定音量漸變的轉(zhuǎn)場提示。這類重復性勞動手剪容易厭倦寫成腳本反而一勞永逸from moviepy.editor import VideoFileClip, TextClip, CompositeVideoClip # 批量給視頻加標題 video VideoFileClip(input.mp4) txt TextClip(My Favorite Scene, fontsize70, colorwhite, duration3) result CompositeVideoClip([video, txt.set_position((center, 100)).set_duration(3)]) result.write_videofile(output.mp4, codeclibx264)把這段邏輯包在for循環(huán)里一次跑一百個視頻都行。這種下載 剪輯鏈路實現(xiàn)了從保存到加工的完整閉環(huán)。5. 常見問題與排查技巧實錄5.1 解析失敗或者提示暫不支持用yt-dlp拉B站鏈接偶爾會遇到解析失敗、返回錯誤碼、或者提示Video unavailable。出現(xiàn)這種情況九成原因是B站接口調(diào)整后本地安裝的yt-dlp版本過舊下載器沒有跟上網(wǎng)站變化。解決方案就是升級pip install -U yt-dlp如果升級后仍然失敗考慮B站的地區(qū)限制或登錄狀態(tài)要求。部分視頻尤其是番劇、電影、紀錄片只對登錄用戶開放下載。此時需要為yt-dlp提供登錄信息yt-dlp --cookies-from-browser edge 目標視頻鏈接--cookies-from-browser會直接從你本地的瀏覽器讀取登錄態(tài)Cookie支持chrome、edge、firefox、opera等讓yt-dlp以你的賬號身份去訪問視頻源。這樣番劇、會員專屬內(nèi)容都能正常解析。注意這是個較為敏感的操作只在你要合法保存?zhèn)€人可訪問內(nèi)容時使用。5.2 下載速度慢、顯示限流B站對非登錄用戶的視頻流請求會做限速和風控。解決思路有兩個維度。第一盡量使用Cookie登錄態(tài)請求登錄態(tài)的請求優(yōu)先級明顯高于匿名請求速度會有直觀提升。第二合理設(shè)置并發(fā)數(shù)yt-dlp -N 4 目標視頻鏈接-N參數(shù)控制同時下載的分片數(shù)提高并發(fā)可以有效對抗B站默認的流式分片限速。但并發(fā)值不是越大越好太高的并發(fā)可能觸發(fā)風控反而降速我自己測試下來4-6是穩(wěn)定區(qū)間。如果B站把你的IP臨時限制了別急著換IP過幾分鐘再試往往就能恢復。千萬不要同一時間并發(fā)大量的下載任務(wù)容易被拉黑列表。5.3 文件下載完成但沒有聲音或無法播放這是最常見的翻車場景。原因有幾種第一是FFmpeg沒有正確安裝或沒有加入PATH。yt-dlp在合并音視頻時找不到FFmpeg就會放棄合并最后留下一個.webm或.m4a音頻文件和一個無聲音的視頻文件。檢查FFmpeg是否可用最簡單的方式就是執(zhí)行ffmpeg -version。第二是封裝格式不兼容。比如B站某些視頻的音頻軌是opus編碼如果強制合并成mp4容器舊設(shè)備會無法解碼播放。解決方法是改用mkv容器或用參數(shù)指定音頻重新編碼yt-dlp -f bv*ba/b --recode-video mp4 目標視頻鏈接--recode-video mp4會在合并完成后重新編碼成mp4容器兼容性最好代價是耗時變長一些。第三是下載的編碼格式超出本地播放器解碼能力。B站現(xiàn)在有AV1、HEVC、AVC三種視頻編碼方案。如果你的設(shè)備播放器較舊AV1解碼會卡頓甚至黑屏。下載前用-F看一眼格式ID優(yōu)先選avc或h264編碼的版本。5.4 誤刪文件后的補救策略下載的東西多了難免有手滑刪錯的時候。如果視頻文件已經(jīng)被刪但對應(yīng)的*.info.json還在yt-dlp 提供了一個從元數(shù)據(jù)恢復下載的技巧yt-dlp --load-info-json xxxx.info.json 視頻鏈接這個操作會讀取舊的JSON文件中的視頻元數(shù)據(jù)重新發(fā)起下載并且輸出文件名與原文件一致方便恢復到原有目錄結(jié)構(gòu)。當然這個方法依賴鏈接仍然有效如果源視頻已被UP主刪除就只能靠本地有沒有做過其他備份了。所以我現(xiàn)在養(yǎng)成了一個習慣重要的素材不僅存本地還會在網(wǎng)盤或移動硬盤再放一份。特別是做二創(chuàng)的素材原視頻一旦在B站下架本地就是唯一來源了只有零備份才是真的丟失。5.5 不同平臺播放入庫的統(tǒng)一方案下載后如果要在不同設(shè)備間互傳播放建議保持一個統(tǒng)一規(guī)范能選1080p就選1080p容器最好固定為mp4編碼優(yōu)先H.264。這個組合在手機、電腦、電視盒子、投影儀上的兼容性最高基本不會因為編碼問題打不開。如果追求更高觀影體驗4KHDR的版本可以單獨建一個收藏原盤目錄不跟日常播放庫混在一起。批量統(tǒng)一轉(zhuǎn)碼的命令也不難for f in *.mkv; do ffmpeg -i $f -c:v libx264 -c:a aac ${f%.mkv}.mp4; done這套方法適合整理大型收藏的時統(tǒng)一格式缺點是耗時我會放在睡覺前跑一整晚。別忘了下載和轉(zhuǎn)碼都是CPU/GPU密集任務(wù)筆記本注意散熱。6. 合規(guī)使用與個人經(jīng)驗分享關(guān)于下載B站視頻我一直堅持三個原則。第一只下載自己有權(quán)訪問的內(nèi)容主要用于個人學習、資料備份與二次創(chuàng)作第二如果涉及發(fā)布、傳播嚴格遵守原作者聲明和平臺規(guī)則分享時注明出處、標注原作者第三不用下載能力去批量搬運他人原創(chuàng)內(nèi)容那既是對創(chuàng)作者的不尊重也可能給自己帶來版權(quán)糾紛。開源工具放大的是個人的創(chuàng)作自由度不是搬運的工具箱。我個人在實際操作中的最大體會是yt-dlp 真正的價值不在下載這個動作本身而在于把你從平臺的內(nèi)容圍欄中解放出來。你可以自主控制素材的清晰度、封裝、字幕、命名規(guī)則甚至把整個下載流程接入自己的自動化腳本。這套工作流一旦搭建好之后每一次收藏視頻花費的時間基本就是個位數(shù)秒。再分享一個進階思路如果你把下載后的視頻、信息JSON、封面圖全部按照固定規(guī)則歸檔還能結(jié)合一些開源媒體管理工具搭建私人影音庫。比如把yt-dlp的輸出目錄指向Jellyfin的媒體庫B站下載的視頻自動出現(xiàn)在家庭影院里電視上直接觀看。這種下載-歸檔-管理的三級結(jié)構(gòu)才是這套工具的完全體用法。工具在更新平臺會改版但這套以開源工具為核心的個人收藏體系的方法是穩(wěn)定的。希望這篇記錄能給同樣喜歡存視頻的朋友一點參考。如果你在自己操作中遇到了什么新報錯或者有趣的折騰思路歡迎在評論區(qū)聊聊我盡量把對應(yīng)的問題更新到后面的經(jīng)驗補充里。