# 使用 vcpkg 管理套件

**vcpkg** 是免費的 C/C++ 套件管理器，使用於取得和管理函式庫。從超過 1500 個開放原始碼函式庫中選擇，僅需單一步驟，即可下載與建構或新增自己的私有函式庫，以簡化建構流程。由 Microsoft C++ 團隊和開放原始碼貢獻者維護。在 [Vcpkg Port Explorer](https://vcpkg.link/) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 的「Supports」部分中，可以找到相依套件以及支援的平台。

**支援的平台**

下表提供跨不同平台的套件支援範例。

| 套件名稱 | 支援情況 | 說明 |
| --- | --- | --- |
| qt5-base | All | 支援所有平台。 |
| opencv2 | !uwp & !(arm & windows) | 不支援 UWP 及 Windows on Arm。 |
| libtorch | (windows & !static) | osx | linux | 支援 Windows（非靜態鏈接）、MacOS 和 Linux。 |
| rocksdb | !uwp & !(arm & !arm64 & android) | 不支援 UWP、Arm（除了 Arm64 以外）、Android。 |
| ncnn | !(windows & arm) | 不支援 Windows on Arm。 |
| tbb | (windows & !uwp) | linux | osx | ios | android | 支援 Windows（除了 UWP）、Linux、MacOS、iOS 和 Android。 |
| openmvg | (x86 | x64 | arm64) & !xbox | 支援 x86（除了 Xbox）、x64（除了 Xbox）以及 Arm64（除了 Xbox）。 |

## 開始使用 vcpkg

vcpkg 工具相當實用，可用於下載並管理函式庫，以避免在建置過程中出現相依性問題。

**安裝的前置條件**

- WoS PC
- Windows 7 或更新的版本
- Git
- Visual Studio 2015 或更新的版本

### 安裝 vcpkg

1. 複製 vcpkg 儲存庫。

git clone https://github.com/Microsoft/vcpkg.git
        Copy to clipboard
2. 運行引導腳本以建置 vcpkg。

.\vcpkg\bootstrap-vcpkg.bat
        Copy to clipboard
3. 安裝專案函式庫。

vcpkg install package_name:arm64-windows
        Copy to clipboard

    在安裝 vcpkg 之後，使用命令 `vcpkg install package_name:arm64- windows`。將會自動進行以下動作：

![../../_images/vcpkg_flow_chart.png](data:image/png;base64,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)

    更多資訊和詳細紀錄（logs）請見： `\vcpkg\buildtrees\detect_compiler\config-arm64-windows-rel-CMakeCache.txt.log` 及 `\vcpkg\buildtrees\detect_compiler\config-arm64-windows-out.log` 。
4. 移除專案函式庫。

vcpkg remove package_name:arm64-windows
        Copy to clipboard

### vcpkg 目錄結構

下表說明 vcpkg 分支的內容：

| `Buildtrees` | 建構過程中產生的臨時文件及中間結果。 |
| --- | --- |
| `Docs` | 文檔與範例 |
| `Installed` | 已建立和安裝的相依性函式庫。將 Visual Studio 或 CMake 與 vcpkg 搭配使用時，vcpkg 會在此處搜尋需要的檔案。 |
| `Downloads` | 已下載相依函式庫的原始碼檔案。 |
| `Packages` | 用於不同安裝版本之間的臨時過渡區。 |
| `Ports` | 描述每個函式庫的目錄、版本及下載位置的檔案。 |
| `Scripts` | vcpkg 使用到的腳本（CMake、PowerShell）。 |
| `Toolsrc` | vcpkg 及相關元件的 C++ 原始碼檔案。 |
| `Triplets` | 每個支援的目標平台上要使用的設置，例如 arm64-windows。 |

以下是 *vcpkg/installed/arm64-windows/* 子目錄的內容說明：

| `Bin` | （發佈版本）已安裝的相依套件庫的二進位執行檔。 |
| --- | --- |
| `Lib` | （發佈版本）已安裝的相依套件庫的靜態庫檔案。 |
| `Debug` | （調試版本）調試符號檔：已安裝的相依套件庫的調試符號檔案。 |
| `Share` | 已安裝的相依套件庫的共用檔案，如資源與設定檔等共用文件。 |
| `Include` | 已安裝的相依套件庫的標頭檔。 |
| `Tools` | 建置已安裝的相依套件庫所需的工具與腳本。 |
| `Manual-tools` | 手動安裝的工具或資料庫。 |

## 問題排解

本頁面列出了常見的 vcpkg 常見問題與相應的排除程序

### 常用的 vcpkg 指令

以下為常用的 vcpkg 命令。在排除套件安裝問題時，此類命令可能有幫助。

| `vcpkg install package_name` | 安裝指定的軟體套件 |
| --- | --- |
| `vcpkg remove package_name` | 從 vcpkg 中移除指定的軟體套件 |
| `vcpkg list` | 列出所有已安裝的軟體套件 |
| `vcpkg search package_name` | 搜尋指定名稱的軟體套件來確認其是否可用 |
| `vcpkg update` | 更新 vcpkg 本身以及已安裝的軟體套件到最新的版本 |
| `vcpkg upgrade` | 將已安裝的軟體套件更新到最新的版本 |

如需進一步的協助或查看常見問答，請參考以下資源： [https://github.com/microsoft/vcpkg/issues](https://github.com/microsoft/vcpkg/issues) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 及 [https://github.com/microsoft/vcpkg/discussions](https://github.com/microsoft/vcpkg/discussions) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 。

### 無法安裝函式庫

有時候 vcpkg 可能無法安裝函式庫。如果發生此情況時，請進行以下操作：

- 確保本機程式碼處於最新狀態：`git pull https://github.com/microsoft/ vcpkg`。
- 執行以下指令：`vcpkg install package_name:arm64-windows --debug` ，以取得更詳細的除錯紀錄資訊。
- 重新開啟命令提示字元。

### 無法在 WoS 平台上安裝 openh264

1. 要安裝 openh264 時，請在命令行中運行以下命令：

vcpkg install openh264:arm64-windows
        Copy to clipboard
2. 如果安裝失敗：

    1. 利用 **nasm -v** 指令確認 nasm 是否正確安裝。
    2. 將已安裝完成的 `nasm.exe` 添加到環境變數中。

如需更多資訊，請參考以下紀錄：

- CMake 的錯誤紀錄，位於 scripts/cmake/vcpkg\_execute\_required\_process.cmake:112 (message)……
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\openh264\config-arm64-windows-dbg-meson-log.txt.log: ..\src\33cf500b7b-c619a10b3a.clean\meson.build:132:2: 錯誤：找不到’nasm’程式或程式不可執行
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\openh264\config-arm64-windows-dbg-out.log ..\src\33cf500b7b-c619a10b3a.clean\meson.build:132:2: 錯誤：找不到’nasm’程式或程式不可執行

### 無法在 WoS 平台上安裝 qt5-base

要安裝 qt5-base 時，請在命令行中運行以下命令：

vcpkg install qt5-base:arm64-windows
    Copy to clipboard

但是 vcpkg 會忽略旗標，且目前 [無有效的解決方案](https://github.com/microsoft/vcpkg/issues/26974) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=)。若需要更多支援時，請直接聯絡 Microsoft。

如需更多資訊，請參考以下紀錄：

- 錯誤紀錄：CMake Error，位於 scripts/cmake/vcpkg\_execute\_required\_process.cmake:112 (message)
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\qt5-base\config-arm64-windows-dbg-out.log
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\qt5-base\config-arm64-windows-dbg-err.log

Project ERROR: SDK setup script failed. Output:
        ===================
        [ERROR:vcvarsall.bat] Invalid argument found : Unknown_arm64
        [ERROR:vcvarsall.bat] Error in script usage. The correct usage is:
        Copy to clipboard

    語法：

vcvarsall.bat [arch] [platform_type] [winsdk_version] [-vcvars_ver=vc_version] [-vcvars_spectre_libs=spectre_mode]
        Copy to clipboard

    請確保 Visual Studio 或 C++ Build SKU 已經安裝在裝置上。

### 安裝/建置過程過於耗時

vcpkg可能需要一些時間安裝和建立套件，尤其是大型套件及複雜套件。建立整個函式庫，可能需要 40 分鐘。

### 函式庫不支援 Windows ARM64 目標

若想要將函式庫新增為 Windows ARM64 目標，請聯絡函式庫所有者。函式庫所有者必須更新每一個函式庫的上游建構流程，才能以 Windows Arm64 為目標。

Last Published: Dec 16, 2025

[Previous Topic
使用 clang++/LLVM 工具進行建置](https://docs.qualcomm.com/bundle/publicresource/80-62010-1TC/topics/build-clang-llvm.md) [Next Topic
移植](https://docs.qualcomm.com/bundle/publicresource/80-62010-1TC/topics/port.md)