AGX Xavier 場景下的 【OpenCV + FFmpeg + CUDA + GStreamer】 重裝 & 編譯的2025年穩定方案

? 1?? 先卸載老版本

AGX 自帶很多預裝包，原則：卸載干凈，避免舊庫和新編譯沖突。

---

🔹 卸載 OpenCV

dpkg -l | grep opencv
sudo apt-get remove --purge libopencv* python3-opencv# 自己 make install 裝過的也一起刪
sudo rm -rf /usr/local/include/opencv4
sudo rm -rf /usr/local/lib/libopencv*
sudo rm -rf /usr/local/lib/pkgconfig/opencv4.pc
sudo rm -rf /usr/local/lib/python3*/dist-packages/cv2*# 卸載 pip 版本（如果有）
pip3 uninstall opencv-python opencv-contrib-pythonsudo ldconfig

🔹 卸載 FFmpeg

dpkg -l | grep ffmpeg
sudo apt-get remove --purge ffmpegsudo rm -rf /usr/local/bin/ffmpeg /usr/local/bin/ffprobe /usr/local/lib/libav*sudo ldconfig

? 2?? 檢查 CUDA 和 GStreamer

AGX Xavier 自帶 CUDA，JetPack 4.5 默認是 CUDA 10.2 + GStreamer 1.14.x
→ 不要自己亂裝 CUDA，保持 JetPack 自帶就行。

檢查一下：

nvcc --version
gst-launch-1.0 --version

確認有：

CUDA compilation tools, release 10.2, V10.2.89
GStreamer 1.14.x

?

? 3?? 安裝依賴

sudo apt-get update# 編譯工具
sudo apt-get install -y build-essential cmake git pkg-config# GStreamer (一定要有)
sudo apt-get install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \gstreamer1.0-plugins-good gstreamer1.0-plugins-bad \gstreamer1.0-plugins-ugly gstreamer1.0-libav# 圖像編解碼
sudo apt-get install -y libjpeg-dev libpng-dev libtiff-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev# OpenGL 和 V4L2
sudo apt-get install -y libgtk-3-dev libcanberra-gtk* libtbb2 libtbb-dev libdc1394-22-dev# Python
sudo apt-get install -y python3-dev python3-numpy

? 4?? 編譯 OpenCV (推薦 4.5.5)

🔹 拉源碼

cd ~
git clone https://github.com/opencv/opencv.git
cd opencv
git checkout 4.5.5cd ~
git clone https://github.com/opencv/opencv_contrib.git
cd opencv_contrib
git checkout 4.5.5cd ~/opencv
mkdir build && cd build

將opencv_contrib放在opencv的文件夾下。后面配置CMake路徑時注意統一。

解決ADE被墻

?cmake的過程中，會因為下載ADE被墻，而停頓，因此只好手動下載。

wget https://github.com/opencv/ade/archive/refs/tags/v0.1.1f.zip
# 解壓到 opencv_contrib/modules/ade 或者 opencv/3rdparty/ade
unzip v0.1.1f.zip
mv ade-0.1.1f/* ~/opencv_build/opencv/3rdparty/ade

opencv/├── 3rdparty/│    ├── ade/│         ├── CMakeLists.txt│         ├── source.cpp ...

只要在 opencv/3rdparty/ade/ 里能找到它的 CMakeLists.txt，就沒問題。

并在CMake是加上一句：

-D OPENCV_ADE_DIR=~/opencv_build/opencv/3rdparty/ade

?解決NVIDIA_OPTICAL_FLOW被墻

🔹 CMake 推薦配置（AGX Xavier 專屬 🚀）

cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local -D OPENCV_EXTRA_MODULES_PATH=~/opencv/opencv_contrib/modules -D WITH_CUDA=ON -D WITH_CUDNN=ON -D OPENCV_DNN_CUDA=ON -D ENABLE_FAST_MATH=ON -D CUDA_FAST_MATH=ON -D WITH_CUBLAS=ON -D WITH_GSTREAMER=ON -D WITH_FFMPEG=ON -D WITH_GSTREAMER_0_10=OFF -D WITH_LIBV4L=ON -D WITH_OPENGL=ON -D WITH_QT=OFF -D BUILD_opencv_python2=OFF -D BUILD_opencv_python3=ON -D PYTHON3_EXECUTABLE=$(which python3) -D PYTHON3_INCLUDE_DIR=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['include'])") -D PYTHON3_LIBRARY=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['stdlib'])") -D OPENCV_GENERATE_PKGCONFIG=ON -D BUILD_TESTS=OFF -D OPENCV_ENABLE_NONFREE=ON -D BUILD_EXAMPLES=OFF -D OPENCV_ADE_DIR=~/opencv/3rdparty/ade ..

需要包含：

-D BUILD_opencv_python3=ON \
-D PYTHON3_EXECUTABLE=$(which python3) \
-D PYTHON3_INCLUDE_DIR=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['include'])") \
-D PYTHON3_LIBRARY=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['stdlib'])") \

?否則會提示：

 python3 -c "import cv2; print(cv2.getBuildInformation())" | grep CUDATraceback (most recent call last):File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'cv2'
nvidia@agxA:~/opencv/build$ python3 -c "import cv2; print(cv2.getBuildInformation())" | grep GStreamer
Traceback (most recent call last):File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'cv2'

🔹 編譯 & 安裝

make -j$(nproc)   # Xavier AGX 建議一次用 4-6 核，別一次全開，避免 OOM
sudo make install
sudo ldconfig

? 5?? （可選）FFmpeg

如果主要用 GStreamer 了，FFmpeg 不必須單獨編譯。

要自己帶硬編解碼：

• Jetson 上推薦用 NVIDIA 提供的 L4T Multimedia API 或者 nvmpi 社區版。

• nvmpi 維護得很久沒更新，新項目直接用 GStreamer + nvarguscamerasrc + nvv4l2decoder 最穩定。

? 6?? 驗證

# OpenCV
python3 -c "import cv2; print(cv2.getBuildInformation())" | grep CUDA
python3 -c "import cv2; print(cv2.getBuildInformation())" | grep GStreamer# GStreamer
gst-inspect-1.0 | grep nv

關鍵點總結：

1?? JetPack 4.5 的 CUDA/FFmpeg/GStreamer 都需要自己編時打開
2?? ADE 可手動解壓替代自動下載
3?? JNI、Tesseract 非剛需可以跳過或后裝
4?? BUILD_opencv_python3=ON 和 Python 路徑一定配好
5?? 不要混用 pip 的 opencv-python，它是 CPU 版，沒 GPU