最常用 yt-dlp 命令和選項的快速參考指南。
yt-dlp 是一個開源命令列工具，是 youtube-dl 的積極維護分支（提供更快的 bug 修復和 1700+ 網站支援），用於下載影片、音訊和播放列表。
此速查表涵蓋下載 1080p/4K 影片、提取 MP3 音訊、繞過機器人檢測和嵌入字幕的常用命令。
初次使用？請訪問我們的全面 yt-dlp 下載與安裝指南，或者直接在我們的 線上控制台 無需任何設定。
更喜歡自己建構命令？試試我們互動式的 yt-dlp 命令產生器 — 選擇選項並獲取準確的命令。
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下載最佳質量的影片（預設行為）。 | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | 使用自定義輸出路徑和檔名模板儲存影片。 | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | 限制下載速度以繞過頻寬限速（例如 50K、10M）。 | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 透過在輸出檔名中嵌入上傳日期和唯一影片 ID 來避免檔案衝突。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | 列出所有可用的解析度、大小、編解碼器和格式。 | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 選擇並下載特定的格式程式碼（先使用 -F 查詢程式碼）。 | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下載 1080p 及以下的最佳影片質量。相同的高度過濾器適用於 1440p (2K) 和 2160p (4K)。 | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | 強制以合併的 MP4 格式下載最佳質量。 | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | 下載影片並重新編碼為標準 MP4（適用於平臺使用 WebM 等非標準容器時）。 |
-f bestvideo+bestaudio 搭配 --merge-output-format mp4 獲取最佳質量和最大裝置相容性。在 ytdlp.online 上，ffmpeg 合併在伺服器端自動處理。
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | 僅提取音訊軌道（自動檢測最佳預設格式）。 | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | 下載音訊並將其轉換為 MP3 格式。 | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | 下載音訊並提取為最佳質量 MP3（VBR 0 / 等效 320kbps）。 | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | 下載 MP3 並嵌入原始影片描述、標籤和縮圖封面。 |
--embed-thumbnail --embed-metadata 可自動獲取專輯封面和歌曲標籤——非常適合 iTunes 或 Spotify 本地檔案等音樂庫應用。
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 強制下載播放列表連結中的所有影片。 | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 僅下載 URL 中的單個影片，忽略其所屬的播放列表。 | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 下載播放列表的指定索引範圍（例如 1-5、1,3,5）。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 列出所有手動上傳和自動生成的字幕。 | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 僅提取和儲存自動生成的字幕檔案，跳過影片下載。 | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下載影片並自動將字幕作為軟字幕嵌入合併的 MP4 檔案中。 | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下載特定語言的手動上傳字幕（例如 en、zh-Hans、ja）。先使用 --list-subs 檢視可用語言。 |
--sub-langs all 下載所有可用語言的字幕，或使用 --sub-langs "en,zh-Hans" 一次抓取多種語言。如需完整字幕參考，請檢視我們的 yt-dlp 幫助頁面.
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 從瀏覽器（例如 chrome、firefox）載入 Cookie 以繞過登入驗證或機器人檢測。 |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 模擬瀏覽器 TLS 客戶端特徵（需要 curl-cffi）以繞過 Cloudflare 和 YouTube 機器人檢測封鎖。 | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 透過強制使用特定的 YouTube 播放器客戶端組合來繞過"請登入以確認您不是機器人"錯誤。 | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 透過 HTTP、HTTPS 或 SOCKS 代理路由 yt-dlp 流量——適用於地理限制內容。 | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 偽造地理位置國家程式碼（例如 US、GB、JP）以繞過地區內容限制。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -a urls.txt | 批次下載文字檔案中逐行列出的所有影片 URL。 |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | 根據影片內部章節自動將影片拆分為單獨的軌道/檔案。 | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | 使用外部多執行緒下載器（Aria2）顯著加速下載。 | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 在下載之間強制隨機延遲（5 到 15 秒）以防止 IP 被封禁。 | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下載特定的影片片段或時間範圍（例如 1m0s 到 2m30s），而非整個影片。 | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 在 archive.txt 中跟蹤下載歷史，自動跳過之前已下載的影片。 |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
winget install yt-dlp。您也可以使用 Scoop、Chocolatey、pip，或直接從 GitHub 下載獨立的 yt-dlp.exe。