Python OpenCV 讀取視頻失敗？路徑不匹配與格式轉換解決方案

錯誤現象

使用 cv2.VideoCapture() 讀取視頻報錯，錯誤信息中的路徑指向 build/ 目錄，而實際視頻位于 source/ 目錄。

常見原因排查

1. 相對路徑錯誤：腳本運行工作目錄非預期，導致相對路徑解析偏差。建議使用絕對路徑或 os.path.join(os.path.dirname(__file__), 'source/video.mp4')。
2. 編解碼器缺失：OpenCV 依賴 FFmpeg 解碼，某些格式（如 HEVC/H.265）在預構建版本中不支持。嘗試轉碼為 H.264 + MP4 容器：
   ffmpeg -i input.mp4 -c:v libx264 -c:a aac output.mp4
3. 路徑包含中文/特殊字符：Windows 下 OpenCV 早期版本對非 ASCII 路徑支持不佳，改用純 ASCII 路徑測試。

用戶最終解決

經確認，視頻格式有問題，使用格式轉換工具轉碼后正常讀取。

最佳實踐

• 開發階段統一使用 H.264/MP4 格式測試視頻。
• 代碼中捕獲 cap.isOpened() 失敗時打印完整絕對路徑便于排查。