Windows下VS Code如何引用MSYS2下载的Crypto++库？

问题描述 #

我是C新手，已安装VS Code的C/C扩展及扩展包，并按指引安装了MSYS2。通过MSYS2下载了mingw-w64-x86_64-crypto++，经pacman -Q验证已安装，且确认该包位于D:\msys64\mingw64\include\cryptopp目录。我已验证VS Code可通过g++.exe正常运行Hello World程序。

尝试引入以下头文件：

#include <cryptopp/sha.h>
#include <cryptopp/hmac.h>
#include <cryptopp/pbkdf2.h>

运行时出现错误：

cryptopp/sha.h: No such file or directory

我的c_cpp_properties.json配置如下：

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "D:\\msys64\\mingw64\\include\\"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "D:\\msys64\\ucrt64\\bin\\gcc.exe",
            "cStandard": "c17",
            "cppStandard": "gnu++17",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

测试程序（已注释部分代码）：

#include <iostream>
#include <string>

#include <cryptopp/sha.h>
#include <cryptopp/hmac.h>
#include <cryptopp/pbkdf2.h>

using namespace CryptoPP;

int main() {
    std::string password = "my_password";
    std::string salt = "random_salt";
    unsigned int iterations = 10000; // 调整迭代次数以控制强度
    unsigned int key_length = 32; // 期望的密钥长度（字节）

    byte key[key_length];

 /*   
    PKCS5_PBKDF2_HMAC<SHA256> pbkdf;
    pbkdf.DeriveKey(key, key_length, (const byte*)password.data(), password.length(),
                   (const byte*)salt.data(), salt.length(), iterations);

    // 将密钥转换为十六进制格式以便显示（可选）
    std::string hex_key;
    HexEncoder encoder;
    encoder.Attach(new StringSink(hex_key));
    encoder.Put(key, key_length);
    encoder.MessageEnd();

    std::cout << "派生密钥: " << hex_key << std::endl;
*/ 
    return 0;
}

解决方案 #

1. 统一MSYS2子系统环境 #

核心问题是编译器路径与库所在的子系统不匹配：

• Crypto++安装在mingw64子系统（对应路径D:\msys64\mingw64\include）
• 但c_cpp_properties.json中指定的编译器属于ucrt64子系统（路径D:\msys64\ucrt64\bin\gcc.exe）

MSYS2的mingw64、ucrt64等子系统完全独立，库与编译器不能跨子系统混用。修改c_cpp_properties.json的compilerPath为mingw64下的gcc：

"compilerPath": "D:\\msys64\\mingw64\\bin\\gcc.exe"

2. 编译时链接Crypto++库 #

即使头文件问题解决，编译阶段还需链接Crypto++库，否则会出现未定义引用错误。在VS Code的tasks.json（无则新建）中，给编译命令添加-lcryptopp参数：
示例tasks.json（用于编译当前活动文件）：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "D:\\msys64\\mingw64\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-lcryptopp" // 新增链接Crypto++库的参数
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: D:\\msys64\\mingw64\\bin\\g++.exe"
        }
    ]
}

3. 验证配置 #

修改完成后：

• 重启VS Code使配置生效
• 取消测试代码中的注释，尝试编译运行

若仍有问题，打开MSYS2的mingw64终端（开始菜单搜索MSYS2 MinGW 64-bit），进入代码所在目录，手动执行编译命令验证：

g++ 你的文件名.cpp -o 输出文件名.exe -lcryptopp

若该命令能成功编译，说明VS Code配置仍需检查；若失败，可通过pacman -Ql mingw-w64-x86_64-crypto++查看所有安装文件路径，确认库文件是否存在。

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