银河麒麟V10系统安装vcpkg的方法

1.环境准备与依赖安装

[2.vcpkg 安装与基础配置](#2.vcpkg 安装与基础配置)

2.1.安装vcpkg

2.2.国内镜像源配置

2.3.验证vcpkg

3.系统架构和对应脚本

[3.1.银河麒麟 V10/V11（x86_64 架构）](#3.1.银河麒麟 V10/V11（x86_64 架构）)

[3.2.银河麒麟 V10/V11（ARM64/aarch64 架构，飞腾 / 鲲鹏）](#3.2.银河麒麟 V10/V11（ARM64/aarch64 架构，飞腾 / 鲲鹏）)

[3.3.银河麒麟 V10/V11（LoongArch64 / 龙芯架构）](#3.3.银河麒麟 V10/V11（LoongArch64 / 龙芯架构）)

[3.4.银河麒麟 V4（x86_64/ARM64 通用）](#3.4.银河麒麟 V4（x86_64/ARM64 通用）)

1.环境准备与依赖安装

查看系统CPU架构：

cpp 复制代码

uname -m

x86_64：普通 64 位 x86 架构
aarch64：ARM64 架构（飞腾、鲲鹏处理器）
loongarch64：龙芯架构（需自定义三元组）

查看glibc版本：

cpp 复制代码

# 方法1：查看ldd版本
ldd --version
# 统信UOS示例输出：
# ldd (Debian GLIBC 2.28.31-deepin1) 2.28 

# 方法2：查看glibc库版本
ls -l /lib/x86_64-linux-gnu/libc.so.6
# 输出类似：libc.so.6 -> libc-2.28.so

# 方法3：检查程序依赖的glibc版本
readelf -V /bin/ls | grep -A5 "Version definition"
# 输出包含GLIBC_2.28等版本信息

本人的银河麒麟V10系统输出如下：

银河麒麟系统基于 Linux 内核，需先安装基础编译工具链和依赖库：

cpp 复制代码

# 银河麒麟V10/V11（Debian/Ubuntu兼容）
sudo apt update && sudo apt install -y \
  git build-essential cmake ninja-build \
  pkg-config curl zip unzip tar \
  libssl-dev zlib1g-dev liblzma-dev

# 银河麒麟V4（老版本）
sudo yum install -y \
  git gcc gcc-c++ cmake ninja-build \
  pkgconfig curl zip unzip tar \
  openssl-devel zlib-devel xz-devel

关键依赖说明：

CMake：建议 3.20 + 版本，vcpkg 最新版要求
GCC/G++：建议 8.3+，支持 C++17 标准
Git：用于克隆 vcpkg 仓库
SSL/zlib：解决大部分库的网络与压缩依赖

2.vcpkg 安装与基础配置

2.1.安装vcpkg

cpp 复制代码

# 克隆vcpkg仓库（推荐最新版）
git clone https://github.com/microsoft/vcpkg.git
cd vcpkg

# 运行引导脚本（自动适配Linux）
./bootstrap-vcpkg.sh

# （可选）设置全局可用
sudo ln -s $(pwd)/vcpkg /usr/local/bin/vcpkg

# 验证安装
vcpkg --version

2.2.国内镜像源配置

解决 GitHub 资源下载慢 / 失败问题：

方法1(没有验证过，自己看着办)：

cpp 复制代码

# 临时生效（当前终端）
export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"
export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"

# 永久生效（写入配置文件）
echo 'export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"' >> ~/.bashrc
echo 'export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"' >> ~/.bashrc
source ~/.bashrc

# （备选）创建vcpkg-configuration.json文件（推荐）
cat > vcpkg-configuration.json << EOL
{
  "registries": [
    {
      "kind": "artifact",
      "location": "https://mirror.tuna.tsinghua.edu.cn/vcpkg/",
      "name": "tuna"
    }
  ]
}
EOL

方法2：用国内的镜像下载vcpkg

网址：https://gitee.com/elayan/vcpkg
git地址：https://gitee.com/elayan/vcpkg.git

虽然vcpkg包下载下来了，但是执行./bootstrap-vcpkg.sh的时候一般都会卡住，因为执行./bootstrap-vcpkg.sh的第一步就是下载www.github.com合适的glibc版本,国内网都不是很稳定，基本上都下载失败，所有需要翻墙加速，我也是用了这个才安装好：

2.3.验证vcpkg

执行./vcpkg,输出：

用vcpkg安装fmt库：

cpp 复制代码

./vcpkg install fmt:x64-linux

输出如下：

说明vcpkg已安装好。

3.系统架构和对应脚本

3.1.银河麒麟 V10/V11（x86_64 架构）

cpp 复制代码

# 1. 更新系统并安装基础编译依赖
sudo apt update && sudo apt install -y git build-essential cmake ninja-build pkg-config curl zip unzip tar libssl-dev zlib1g-dev liblzma-dev
# 2. 克隆vcpkg仓库并进入目录
cd ~ && git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
# 3. 执行引导脚本，编译vcpkg主程序
./bootstrap-vcpkg.sh
# 4. 设置全局命令，方便任意终端使用
sudo ln -s $(pwd)/vcpkg /usr/local/bin/vcpkg
# 5. 配置清华镜像源（解决国内下载慢/失败，永久生效）
echo 'export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"' >> ~/.bashrc
echo 'export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"' >> ~/.bashrc
echo 'export VCPKG_DEFAULT_TRIPLET="x64-linux"' >> ~/.bashrc
# 6. 刷新环境变量，立即生效
source ~/.bashrc
# 7. 验证安装并测试安装基础库
vcpkg --version && vcpkg install fmt:x64-linux
echo "银河麒麟V10/V11 x86_64架构vcpkg适配完成！"

3.2.银河麒麟 V10/V11（ARM64/aarch64 架构，飞腾 / 鲲鹏）

cpp 复制代码

# 1. 更新系统并安装基础编译依赖
sudo apt update && sudo apt install -y git build-essential cmake ninja-build pkg-config curl zip unzip tar libssl-dev zlib1g-dev liblzma-dev
# 2. 克隆vcpkg仓库并进入目录
cd ~ && git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
# 3. 执行引导脚本，编译vcpkg主程序
./bootstrap-vcpkg.sh
# 4. 设置全局命令，方便任意终端使用
sudo ln -s $(pwd)/vcpkg /usr/local/bin/vcpkg
# 5. 配置清华镜像源+默认ARM64三元组（永久生效）
echo 'export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"' >> ~/.bashrc
echo 'export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"' >> ~/.bashrc
echo 'export VCPKG_DEFAULT_TRIPLET="arm64-linux"' >> ~/.bashrc
# 6. 刷新环境变量，立即生效
source ~/.bashrc
# 7. 验证安装并测试安装基础库
vcpkg --version && vcpkg install fmt:arm64-linux
echo "银河麒麟V10/V11 ARM64架构vcpkg适配完成！"

3.3.银河麒麟 V10/V11（LoongArch64 / 龙芯架构）

cpp 复制代码

# 1. 更新系统并安装基础编译依赖
sudo apt update && sudo apt install -y git build-essential cmake ninja-build pkg-config curl zip unzip tar libssl-dev zlib1g-dev liblzma-dev
# 2. 克隆vcpkg仓库并进入目录
cd ~ && git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
# 3. 执行引导脚本，编译vcpkg主程序
./bootstrap-vcpkg.sh
# 4. 设置全局命令，方便任意终端使用
sudo ln -s $(pwd)/vcpkg /usr/local/bin/vcpkg
# 5. 创建龙芯专属三元组文件（核心适配步骤）
mkdir -p triplets/loongarch64-linux
cat > triplets/loongarch64< EOF
set(VCPKG_TARGET_ARCHITECTURE loongarch64)
set(VCPKG_CMAKE_SYSTEM_NAME Linux)
set(VCPKG_CMAKE_SYSTEM_PROCESSOR loongarch64)
set(VCPKG_LIBRARY_LINKAGE dynamic)
set(VCPKG_CRT_LINKAGE dynamic)
EOF
# 6. 配置清华镜像源+默认龙芯三元组（永久生效）
echo 'export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"' >> ~/.bashrc
echo 'export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"' >> ~/.bashrc
echo 'export VCPKG_DEFAULT_TRIPLET="loongarch64-linux"' >> ~/.bashrc
# 7. 刷新环境变量，立即生效
source ~/.bashrc
# 8. 验证安装并测试安装基础库
vcpkg --version && vcpkg install fmt:loongarch64-linux
echo "银河麒麟V10/V11 龙芯LoongArch64架构vcpkg适配完成！"

3.4.银河麒麟 V4（x86_64/ARM64 通用）

cpp 复制代码

# 1. 更新系统并安装基础编译依赖
sudo yum install -y git gcc gcc-c++ cmake ninja-build pkgconfig curl zip unzip tar openssl-devel zlib-devel xz-devel
# 2. 克隆vcpkg旧稳定版（适配V4老系统，避免新版本兼容问题）
cd ~ && git clone https://github.com/microsoft/vcpkg.git --branch 2021.09.30
cd vcpkg
# 3. 执行引导脚本，编译vcpkg主程序
./bootstrap-vcpkg.sh
# 4. 设置全局命令，方便任意终端使用
sudo ln -s $(pwd)/vcpkg /usr/local/bin/vcpkg
# 5. 配置清华镜像源（永久生效）
echo 'export X_VCPKG_ASSET_SOURCES="x-azurl,https://mirrors.tuna.tsinghua.edu.cn/vcpkg/assets/"' >> ~/.bashrc
echo 'export VCPKG_DOWNLOAD_MIRROR="https://mirrors.tuna.tsinghua.edu.cn/github-release/"' >> ~/.bashrc
# 6. 刷新环境变量，立即生效
source ~/.bashrc
# 7. 验证安装并测试安装基础库（x86选x64-linux，ARM选arm64-linux）
vcpkg --version && vcpkg install fmt:x64-linux
echo "银河麒麟V4 vcpkg适配完成！"