Python調(diào)用C++動態(tài)庫詳細步驟(附源碼)

更新時間：2025年05月19日 10:27:32 作者：鬼魅-9527

在某些項目中需要在python工程中調(diào)用自定義的C++的動態(tài)庫,分為以下兩步,第一步：動態(tài)庫生成；第二步：Python調(diào)用動態(tài)庫,文章通過圖文介紹的非常詳細,需要的朋友可以參考下

一：直接調(diào)用C++庫

第一步：動態(tài)庫封裝（vs2017+qt5.12.10）

1、新建工程時，一定要選擇qt下的Qt Class Library 這個選項，如下圖所示

2、工程創(chuàng)建成功后，可以在解決方案下看到有testLib.h、testLib.cpp和testlib_global.h三個基礎(chǔ)的文件生成，如下圖所示

3、下面我們簡單寫一個打印“vs2017+qt5.12.10生成動態(tài)庫”的輸出函數(shù)

testlib_global.h

#pragma once
 
#include <QtCore/qglobal.h>
#include <qDebug>
 
 
 
#ifndef BUILD_STATIC
# if defined(TESTLIB_LIB)
#  define TESTLIB_EXPORT Q_DECL_EXPORT
# else
#  define TESTLIB_EXPORT Q_DECL_IMPORT
# endif
#else
# define TESTLIB_EXPORT
#endif

testLib.h

#pragma once
 
#include "testlib_global.h"
 
class TESTLIB_EXPORT testLib
{
public:
    testLib();
 
	/**************************************************
	* @author 鬼魅-9527
	* @brief : 說明
	* @param-in: 無
	* @param-out : 無
	* @return : 無
	* @date : 2025-01-01
	**************************************************/
	bool PrintfString();
};
/*將接口轉(zhuǎn)義供外部調(diào)用*/
extern "C"
{
	testLib obj;
	extern "C" _declspec(dllexport) bool __cdecl PrintfString()
	{
		return obj.PrintfString();
	}
}

testLib.cpp

#include "testLib.h"
 
testLib::testLib()
{
}
 
bool testLib::PrintfString()
{
	/*使用QStringLiteral，否則中文輸出會亂碼*/
	qDebug() << QStringLiteral("vs2017+qt5.12.10生成動態(tài)庫");
 
	return true;
}

4、下面我們可以編譯生成動態(tài)庫

第二步：Python調(diào)用C++動態(tài)庫

1、打開vs code 并在動態(tài)庫目錄下新建一個test.py文件

test.py

#導入Python調(diào)用c++的ctypes庫
import ctypes
 
# 加載dll
my_dll = ctypes.CDLL("Z:/Demo/testLib/x64/Release/testLib.dll")
 
# 調(diào)用dll中的函數(shù)
my_dll.PrintfString()

2、通過終端執(zhí)行Python test.py，如下所示

3、從輸出結(jié)果可以看到提示加載庫錯誤，這里出現(xiàn)錯誤的原因是，test.dll依賴的其他的庫并沒有找到，因此需要使用在test.dll目錄下使用windeployqt打包test.dll依賴的庫，如下圖所示

3、再次在終端執(zhí)行Python test.py，如下所示，調(diào)用動態(tài)庫打印輸出執(zhí)行成功。

二：調(diào)用傳遞參數(shù)C++庫

在大多數(shù)情況下，我們使用動態(tài)庫調(diào)用時，都涉及參數(shù)傳遞，以下是簡單的參數(shù)傳遞列子。

第一步：動態(tài)庫封裝

testlib_global.h

#pragma once
 
#include <QtCore/qglobal.h>
#include <qDebug>
 
 
 
#ifndef BUILD_STATIC
# if defined(TESTLIB_LIB)
#  define TESTLIB_EXPORT Q_DECL_EXPORT
# else
#  define TESTLIB_EXPORT Q_DECL_IMPORT
# endif
#else
# define TESTLIB_EXPORT
#endif

testLib.h

#pragma once
 
#include "testlib_global.h"
 
class TESTLIB_EXPORT testLib
{
public:
    testLib();
 
	/**************************************************
	* @author 鬼魅-9527
	* @brief : 打印
	* @param-in: 無
	* @param-out : 無
	* @return : 是否成功
	* @date : 2025-01-01
	**************************************************/
	bool PrintfString();
	/**************************************************
	* @author 鬼魅-9527
	* @brief : 參數(shù)傳遞
	* @param-in: num:數(shù)量，str;字符串
	* @return :字符串長度
	* @date : 2025-01-01
	**************************************************/
	int dataInputAndOutput(const int num, const char* str);
};
 
/*將接口轉(zhuǎn)義供外部調(diào)用*/
extern "C"
{
	testLib obj;
	extern "C" _declspec(dllexport) bool __cdecl PrintfString()
	{
		return obj.PrintfString();
	}extern "C" _declspec(dllexport) int __cdecl dataInputAndOutput(const int num, const char* str)
	{
		return obj.dataInputAndOutput(num, str);
	}
}

testLib.cpp

#pragma once
 
#include "testlib_global.h"
 
class TESTLIB_EXPORT testLib
{
public:
    testLib();
 
	/**************************************************
	* @author 鬼魅-9527
	* @brief : 打印
	* @param-in: 無
	* @param-out : 無
	* @return : 是否成功
	* @date : 2025-01-01
	**************************************************/
	bool PrintfString();
	/**************************************************
	* @author 鬼魅-9527
	* @brief : 參數(shù)傳遞
	* @param-in: num:數(shù)量，str;字符串
	* @return :字符串長度
	* @date : 2025-01-01
	**************************************************/
	int dataInputAndOutput(const int num, const char* str);
};
 
/*將接口轉(zhuǎn)義供外部調(diào)用*/
extern "C"
{
	testLib obj;
	extern "C" _declspec(dllexport) bool __cdecl PrintfString()
	{
		return obj.PrintfString();
	}extern "C" _declspec(dllexport) int __cdecl dataInputAndOutput(const int num, const char* str)
	{
		return obj.dataInputAndOutput(num, str);
	}
}

4、下面我們可以編譯生成動態(tài)

第二步：Python調(diào)用C++動態(tài)庫

test.py

#導入Python調(diào)用c++的ctypes庫
import ctypes
 
# 加載dll
my_dll = ctypes.CDLL("Z:/Demo/testLib/x64/Release/testLib.dll")
 
# 調(diào)用dll中的函數(shù)
my_dll.PrintfString()
str1 = "Z:/Demo/testLib/x64/Release/testLib.dll"
str2 = my_dll.dataInputAndOutput(10,str1.encode("utf-8"))
print(str2);

通過終端執(zhí)行Python test.py，如下所示