快捷導(dǎo)航

C++包管理工具vcpkg配置國內(nèi)鏡像源的操作流程

更新時間：2025年11月21日 09:01:27 作者：學亮編程手記

這篇文章主要介紹了如何配置國內(nèi)鏡像源來使用vcpkg管理C++包,包括使用環(huán)境變量、修改配置文件、手動下載工具和使用預(yù)編譯二進制文件等方法,并提供了一個完整的解決方案和分步安裝策略,需要的朋友可以參考下

第一部分：配置國內(nèi)鏡像源

1.1 方法一：使用環(huán)境變量（推薦）

設(shè)置鏡像源環(huán)境變量：

# 設(shè)置清華鏡像源
$env:VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/ninja-build/ninja/"
$env:X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"

# 或者使用中科大鏡像源
$env:VCPKG_DOWNLOAD_MIRROR="https://mirrors.ustc.edu.cn/github-release/ninja-build/ninja/"
$env:X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.ustc.edu.cn/vcpkg/assets/"

1.2 方法二：修改 vcpkg 配置文件

在 vcpkg 根目錄創(chuàng)建或修改 triplets\x64-windows.cmake 文件，添加：

# 在文件末尾添加以下內(nèi)容
set(VCPKG_DOWNLOAD_MIRROR "https://mirrors.tuna.tsinghua.edu.cn/github-release/ninja-build/ninja/")
set(X_VCPKG_ASSET_SOURCES "x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/")

第二部分：完整的解決方案

2.1 一次性解決方案

# 1. 設(shè)置鏡像源環(huán)境變量
$env:VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/ninja-build/ninja/"
$env:X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"

# 2. 設(shè)置代理（如果你有代理的話）
# $env:HTTP_PROXY="http://127.0.0.1:10809"
# $env:HTTPS_PROXY="http://127.0.0.1:10809"

# 3. 先單獨安裝 ninja（解決你當前的錯誤）
.\vcpkg.exe install ninja:x64-windows

# 4. 然后再安裝 opencv4
.\vcpkg.exe install opencv4:x64-windows

2.2 永久配置方案

創(chuàng)建 set-mirror.ps1 腳本文件：

# set-mirror.ps1 - 設(shè)置vcpkg鏡像源
echo "設(shè)置vcpkg國內(nèi)鏡像源..."

# 設(shè)置環(huán)境變量（當前會話有效）
$env:VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/ninja-build/ninja/"
$env:X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"

# 設(shè)置HTTP代理（如果有的話，取消注釋并修改）
# $env:HTTP_PROXY="http://127.0.0.1:10809"
# $env:HTTPS_PROXY="http://127.0.0.1:10809"

echo "鏡像源設(shè)置完成！"
echo "VCPKG_DOWNLOAD_MIRROR = $env:VCPKG_DOWNLOAD_MIRROR"
echo "X_VCPKG_ASSET_SOURCES = $env:X_VCPKG_ASSET_SOURCES"

# 測試下載
.\vcpkg.exe search opencv4

第三部分：手動下載解決方案

3.1 手動下載 ninja

如果鏡像源還是不行，可以手動下載：

手動下載 ninja：

訪問：https://github.com/ninja-build/ninja/releases/download/v1.13.1/ninja-win.zip
或者從國內(nèi)鏡像：https://mirrors.tuna.tsinghua.edu.cn/github-release/ninja-build/ninja/v1.13.1/ninja-win.zip

放置文件：

將下載的 ninja-win.zip 放到 E:\YOLO\cpp\vcpkg-master\downloads\
重命名為：ninja-win-1.13.1.zip

重新運行安裝：

.\vcpkg.exe install opencv4:x64-windows

第四部分：分步安裝策略

由于 OpenCV 依賴很多，建議分步安裝：

# 1. 先安裝基礎(chǔ)依賴
.\vcpkg.exe install zlib:x64-windows
.\vcpkg.exe install libjpeg-turbo:x64-windows
.\vcpkg.exe install libpng:x64-windows
.\vcpkg.exe install libwebp:x64-windows

# 2. 安裝編譯工具
.\vcpkg.exe install ninja:x64-windows

# 3. 安裝其他依賴
.\vcpkg.exe install protobuf:x64-windows
.\vcpkg.exe install flatbuffers:x64-windows

# 4. 最后安裝 opencv
.\vcpkg.exe install opencv4:x64-windows

第五部分：使用預(yù)編譯二進制文件

如果編譯時間太長，可以考慮使用預(yù)編譯的 OpenCV：

5.1 直接下載 OpenCV 預(yù)編譯版本

訪問 OpenCV官網(wǎng)
下載 Windows 版本（例如 opencv-4.11.0-windows.exe）
解壓到 C:\opencv
在 Visual Studio 中手動配置

5.2 手動配置 OpenCV

// 簡單的測試程序
#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    std::cout << "手動配置OpenCV測試" << std::endl;
    
    // 創(chuàng)建一個簡單的圖像
    cv::Mat image(300, 400, CV_8UC3, cv::Scalar(100, 150, 200));
    cv::circle(image, cv::Point(200, 150), 50, cv::Scalar(0, 0, 255), -1);
    
    cv::imshow("手動配置測試", image);
    cv::waitKey(0);
    
    return 0;
}

第六部分：驗證安裝

安裝成功后，創(chuàng)建測試文件：

// test_opencv.cpp
#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    std::cout << "OpenCV安裝測試" << std::endl;
    std::cout << "OpenCV版本: " << CV_VERSION << std::endl;
    
    // 測試基本功能
    cv::Mat image = cv::imread("test.jpg");
    if(image.empty()) {
        std::cout << "創(chuàng)建測試圖像..." << std::endl;
        image = cv::Mat(400, 600, CV_8UC3, cv::Scalar(50, 100, 150));
        cv::circle(image, cv::Point(300, 200), 80, cv::Scalar(0, 255, 0), -1);
        cv::putText(image, "OpenCV Works!", cv::Point(150, 100),
                   cv::FONT_HERSHEY_SIMPLEX, 1.2, cv::Scalar(255, 255, 255), 2);
    }
    
    cv::imshow("OpenCV測試", image);
    cv::waitKey(0);
    
    return 0;
}