编译C++文件时找不到-lpython311链接库的问题求助

问题场景 #

你编写的C++代码如下：

#define PY_SSIZE_T_CLEAN
#include <python3.11\Python.h>

int main(int argc, char **argv){
    Py_Initialize();
    PyRun_SimpleString("print('Hello C++ from Python')");
    Py_Finalize();
    return 0;
}

使用终端编译时遇到两个核心问题：

1. 执行命令 g++ RunFile.cpp -o output -L C:\Python311\libs -lpython311 -I C:\Python311\include，报错：

   cannot find -lpython311: No such file or directory collect2.exe: error: ld returned 1 exit status
   

2. 替换为 -lpython3 后，报错：

   undefined reference to `PyRun_SimpleStringFlags'
   

同时VSCode点击运行按钮无任何反应。

分步解决方法 #

1. 解决“找不到-lpython311”的问题 #

• 检查库文件与编译器架构匹配：打开C:\Python311\libs目录，确认存在python311.lib（Release版）或python311_d.lib（Debug版）。同时确保你使用的g++是64位版本（如MinGW-w64），和Python的安装架构一致（Python 3.11默认是64位），32位编译器无法链接64位库，反之亦然。
• 修正路径格式：Windows路径的反斜杠可能被解析为转义字符，将编译命令中的路径改为斜杠/或双反斜杠\\，例如：

  g++ RunFile.cpp -o output -L C:/Python311/libs -lpython311 -I C:/Python311/include
  

• 确认Python安装组件：如果libs目录下无对应库文件，重新安装Python，勾选**“Download debugging symbols”和“Download debug binaries (requires VS 2017 or later)”**选项，确保开发组件完整安装。

2. 解决“undefined reference to `PyRun_SimpleStringFlags'”的问题 #

• 使用对应版本的库：-lpython3对应旧版Python，与3.11的头文件不兼容，必须链接同版本的python311.lib或python311_d.lib。
• 区分Debug/Release模式：如果用Debug模式编译，需链接调试版库，命令改为：

  g++ -g RunFile.cpp -o output -L C:/Python311/libs -lpython311_d -I C:/Python311/include
  

• 修正头文件引用：将代码中的<python3.11\Python.h>改为<Python.h>，通过-I参数指定include目录即可，避免路径嵌套问题。

3. 解决VSCode运行按钮无反应的问题 #

VSCode默认运行配置未包含Python库的编译参数，需修改.vscode/tasks.json文件，添加自定义编译任务：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "g++ build with Python",
            "type": "shell",
            "command": "g++",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-L",
                "C:/Python311/libs",
                "-lpython311",
                "-I",
                "C:/Python311/include"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"],
            "detail": "Compile C++ with Python 3.11"
        }
    ]
}

保存后，点击VSCode的运行按钮即可使用该配置编译运行。

额外注意事项 #

• 运行生成的exe文件时，确保python311.dll在系统PATH中，或直接将该dll复制到exe所在目录。
• 若使用MinGW编译存在兼容性问题，可尝试改用MSVC编译器（与Python官方编译环境一致）。

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