Windows、macOS 和 Linux 的分步設定指南。
yt-dlp 是一個功能強大的命令列媒體下載器（youtube-dl 的積極維護分支），可讓您從數千個網站下載影片和音訊。由於它在終端中執行，沒有原生圖形介面。
要下載高質量影片（1080p、4K 等）或提取 MP3 音訊，您必須安裝 FFmpeg。此外，強烈推薦安裝 Deno 等 JavaScript 執行時以繞過 YouTube 的限速和機器人封鎖。以下是在您的裝置上設定這些工具的完整指南。
不想安裝軟體？您可以直接在我們的 線上控制台 無需任何配置。
Windows 10 (1809+) 和 Windows 11 預設包含 Windows 包管理器 (winget)。它會自動管理安裝、路徑和更新。
winget install yt-dlp適用於在 Windows 上使用命令列包管理器的高階使用者。
scoop install yt-dlpchoco install yt-dlp直接下載獨立的可執行二進位制檔案。
C:\yt-dlp\，並將下載的 yt-dlp.exe 移入其中。
C:\yt-dlp，然後在所有對話方塊中點選 確定。Homebrew 是 macOS 的標準包管理器。它會自動解析所有依賴項，包括 Python 和 FFmpeg。
brew install yt-dlp或者，您可以使用 MacPorts 包管理器安裝 yt-dlp。
sudo port install yt-dlp將編譯好的二進位制檔案直接下載到本地執行路徑。
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp使用 Python 的 pip 管理器可確保您直接獲取影片提取器指令碼的最新更新。
python3 -m pip install -U yt-dlp透過 Linux 發行版包管理器安裝 yt-dlp。
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlp將獨立的 Linux 二進位制檔案直接下載到本地可執行路徑。
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg 是一個開源媒體庫，yt-dlp 在底層使用它來合併單獨的高畫質影片軌道（1080p、4K）和音訊軌道，或將音訊提取為 MP3。沒有 FFmpeg，yt-dlp 只能下載 720p 或更低質量的帶內建音訊的流。
使用 winget 一條命令安裝 FFmpeg：
winget install Gyan.FFmpeg或者，從 Gyan.dev 下載構建版本，解壓，然後將 bin 目錄添加到您的 PATH 環境變數中。
如果使用 Homebrew，它會自動安裝。手動安裝命令：
brew install ffmpeg透過系統包管理器安裝：
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno 是一個現代 JavaScript 執行時。yt-dlp 在底層使用 Deno 來執行 YouTube 基於 JavaScript 的簽名解密演算法。安裝 Deno 有助於繞過 YouTube 的下載限速和 "n-challenge" 機器人檢測封鎖。
使用 winget 一條命令安裝 Deno：
winget install DenoLand.Deno或者使用 Scoop： scoop install deno
透過 Homebrew 安裝 Deno：
brew install deno使用官方 shell 指令碼安裝 Deno：
curl -fsSL https://deno.land/install.sh | sh執行此指令碼前請確保已安裝 unzip 和 curl。
安裝完成後，開啟終端（PowerShell、命令提示符或 Terminal.app）並執行版本檢查命令驗證一切正常。
在終端中執行版本查詢命令：
yt-dlp --version如果安裝成功，它會列印一個釋出日期版本號，例如：
2026.06.18如果提示"命令未找到"，請確保重新啟動終端或驗證包含 yt-dlp 的資料夾已正確新增到系統環境 PATH。
遇到問題？以下是 Windows、macOS 和 Linux 上最常見 yt-dlp 錯誤的修復方法。
yt-dlp 不在系統 PATH 中。如果您透過 winget、Homebrew 或 pip 安裝，只需關閉並重新開啟終端——PATH 僅對新會話生效。
yt-dlp.exe，需要將其所在資料夾新增到 PATH 環境變數。請參閱上方的詳細 PATH 設定步驟。
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp 或 brew upgrade yt-dlp）。
yt-dlp -U），因為限速繞過方法會頻繁更新。
yt-dlp.exe 使用 PyInstaller 構建，它將 Python 直譯器打包成單個可執行檔案。防毒軟體經常標記 PyInstaller 打包的程式，因為一些惡意軟體也使用相同的打包技術——但 yt-dlp 本身是完全安全的。
winget install yt-dlp 安裝（微軟驗證的包不會被標記）。
YouTube 和其他影片平臺頻繁更新其流媒體協議，這可能導致舊版本的 yt-dlp 停止工作。保持本地安裝更新到最新版本，可自動解決提取錯誤。
如果您直接下載了二進位制檔案或透過 pip 安裝，請在終端中執行內建更新命令：
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
在終端中使用這些基礎命令開始：
| 目標 | 命令 | 操作 |
|---|---|---|
| 下載影片（最佳畫質） | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| 提取 MP3 音訊 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
是的，yt-dlp 是安全的。它是一個 100% 開源專案，採用 Unlicense 許可證，託管在 GitHub 上，擁有 100,000+ 星標和數百名活躍貢獻者。每一行程式碼都可公開審計。
winget 安裝可避免此問題。如果您不想在本地執行可執行檔案，我們的 線上控制台 在我們的伺服器上執行 yt-dlp——您的裝置上無需安裝任何東西。
100K+ ⭐
在 GitHub 上開源
直接在我們的伺服器上執行 yt-dlp 命令。使用我們的網頁介面下載播放列表、錄製直播和即時提取音訊。