跳至內容
yt-dlp

在 Windows 上安裝 yt-dlp

用 winget、Scoop 或直接下載在 Windows 安裝 yt-dlp 與 ffmpeg,並解決之後出現的 PATH 錯誤。

這篇文章還沒翻譯,所以以英文顯示。介面部分仍是你的語言。

1. Install yt-dlp

winget ships with Windows 10 and 11 and handles the PATH for you, which is the part people get wrong when installing by hand.

winget install yt-dlp.yt-dlp

If you already use Scoop or Chocolatey, either is equally fine:

scoop install yt-dlp
choco install yt-dlp

The manual route is a single yt-dlp.exe from the official releases page. Put it in a folder that is on your PATH — dropping it on the Desktop works only while your terminal happens to be in that folder, which is the usual cause of "yt-dlp is not recognized".

2. Install ffmpeg

yt-dlp downloads without ffmpeg, but everything interesting needs it: merging separate video and audio, MP3 extraction, embedding subtitles or thumbnails, cutting sections. Install it now rather than after the first confusing failure.

winget install Gyan.FFmpeg

3. Check it worked

Open a new terminal — an existing one still has the old PATH — and run:

yt-dlp --version
ffmpeg -version

Two version numbers means you are done.

Quoting on Windows

PowerShell and cmd do not quote the way bash does, and a command copied from a Linux-oriented tutorial often breaks for exactly this reason. In PowerShell, single quotes are literal — the safest choice for a format selector or an output template. In cmd, use double quotes. In a .bat file, every % must be doubled.

yt-dlp -o '%(title)s.%(ext)s' URL     # PowerShell
yt-dlp -o "%(title)s.%(ext)s" URL     # cmd
yt-dlp -o "%%(title)s.%%(ext)s" URL   # inside a .bat file

The generator's shell switch produces the right form for each of these, so you can copy without translating.

Updating

A standalone yt-dlp.exe updates itself with yt-dlp -U. Installed via winget, Scoop or Chocolatey, update it through the same tool — self-update will refuse, because the package manager owns the file.

常見問題

Windows 說找不到 yt-dlp,為什麼?
執行檔不在 PATH 裡,或者終端機是在安裝之前就開好的。先開一個新的終端機;如果還不行,就用 winget 或 Scoop 安裝,它們會替你處理 PATH。
Windows 上 yt-dlp 找不到 ffmpeg。
用 winget install Gyan.FFmpeg 安裝,開一個新終端機,再用 ffmpeg -version 檢查。把 ffmpeg.exe 放在 yt-dlp.exe 同一個資料夾裡也可以。
怎麼更新 yt-dlp?
獨立的執行檔用 yt-dlp -U 自我更新。如果是透過套件管理器安裝的,就用那個管理器更新;自我更新會拒絕動不屬於它的檔案。更新能解決的問題比任何 flag 都多。