如何安装用于C语言项目的libsodium库？

各系统安装步骤 #

Linux 系统 #

• Debian/Ubuntu 系发行版
  执行以下命令安装运行库和开发包：

  sudo apt update
  sudo apt install libsodium23 libsodium-dev
  

• RHEL/CentOS/Fedora 系发行版
  执行以下命令：

  # 新版本用dnf
  sudo dnf install libsodium libsodium-devel
  # 旧版本CentOS用yum
  # sudo yum install libsodium libsodium-devel
  

• 通用源码编译安装（适用于所有Linux发行版、需要特定版本的场景）
  下载对应版本源码压缩包，解压后进入源码目录，依次执行：

  ./configure
  make && make check
  sudo make install
  sudo ldconfig
  

macOS 系统 #

• Homebrew 安装（推荐）

  brew install libsodium
  

• 源码编译安装，步骤和Linux源码安装完全一致。

Windows 系统 #

• MinGW/MSYS2 环境
  打开MSYS2终端执行对应命令：

  # 64位版本
  pacman -S mingw-w64-x86_64-libsodium
  # 32位版本
  pacman -S mingw-w64-i686-libsodium
  

• MSVC 环境
  下载官方预编译的MSVC版本压缩包，解压后按以下配置：
  • 把include目录下的所有文件添加到项目头文件搜索路径
  • 把对应架构的lib目录添加到项目库文件搜索路径
  • 运行时把对应dll文件放到程序执行目录

C 项目集成配置 #

直接用gcc/clang编译 #

编译时添加-lsodium参数链接库即可，示例：

gcc your_code.c -o your_program -lsodium

Makefile 项目 #

在Makefile的链接参数中添加-lsodium，示例：

CC = gcc
LDFLAGS = -lsodium

your_program: your_code.c
	$(CC) your_code.c -o [你的程序名] $(LDFLAGS)

CMake 项目 #

在CMakeLists.txt中添加以下配置：

cmake_minimum_required(VERSION 3.10)
project(your_project)

# 查找libsodium库
find_package(sodium REQUIRED)
include_directories(${sodium_INCLUDE_DIR})

add_executable(your_program your_code.c)
# 链接libsodium库
target_link_libraries(your_program ${sodium_LIBRARY_RELEASE})

安装验证 #

可以用以下测试代码验证安装和配置是否正确：

#include <sodium.h>
#include <stdio.h>

int main() {
    if (sodium_init() == -1) {
        printf("libsodium初始化失败\n");
        return 1;
    }
    printf("libsodium安装成功，当前版本：%s\n", sodium_version_string());
    return 0;
}

编译运行后如果输出版本号，即说明配置正常。

内容的提问来源于stack exchange，提问作者Ernesto Vazquez