在PySide2+QML中使用KDDockWidgets 2.0的配置疑问

一、修复Python模块未生成的问题 #

你的CMake脚本仅完成了构建配置，缺少实际编译和安装步骤，这是site-packages目录无相关文件的核心原因。按以下步骤补全脚本：

1. 补全构建与安装命令
   在cmake配置指令后，添加编译和安装步骤（基于VS2022的MSBuild工具）：

msbuild /m /p:Configuration=Release ALL_BUILD.vcxproj
msbuild /p:Configuration=Release INSTALL.vcxproj

• /m：启用多核编译，提升构建速度
• /p:Configuration=Release：匹配之前指定的Release构建模式

完整脚本如下：

setlocal
set VS_YEAR="2022"
set KDDW_REPO="KDDW"
set PY_ENV_NAME="env"
set PY_SITE_PKG="F:\Projects\Code\Python\boslin\env\Lib\site-packages\"
call "C:\Program Files\Microsoft Visual Studio\%VS_YEAR%\Community\VC\Auxiliary\Build\vcvarsall.bat" x64
cd %KDDW_REPO%
cmake . -DCMAKE_BUILD_TYPE=Release -DKDDockWidgets_PYTHON_BINDINGS=True -DKDDockWidgets_PYTHON_BINDINGS_INSTALL_PREFIX=%PY_SITE_PKG%
msbuild /m /p:Configuration=Release ALL_BUILD.vcxproj
msbuild /p:Configuration=Release INSTALL.vcxproj
endlocal

2. 验证模块生成结果
   执行完安装步骤后，前往%PY_SITE_PKG%目录检查，应该能看到包含__init__.py的kddockwidgets文件夹，以及配套的Qt插件、资源文件。

二、QML中集成KDDockWidgets绑定 #

1. Python代码中初始化绑定
   在PySide2应用入口处，先导入并初始化KDDockWidgets，确保QML引擎能识别相关组件：

import sys
from PySide2.QtWidgets import QApplication
from PySide2.QtQml import QQmlApplicationEngine
import kddockwidgets

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # 初始化KDDockWidgets的QML支持
    kddockwidgets.initQml()
    
    engine = QQmlApplicationEngine()
    engine.load("main.qml")
    
    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec_())

2. QML文件中导入模块
   在QML文件开头添加导入语句，版本号匹配KDDockWidgets 2.0：

import KDDockWidgets 2.0

之后即可使用MainWindow、DockWidget等组件，示例：

import QtQuick 2.15
import QtQuick.Controls 2.15
import KDDockWidgets 2.0

ApplicationWindow {
    visible: true
    width: 800
    height: 600
    
    MainWindow {
        id: mainWindow
        anchors.fill: parent
        
        DockWidget {
            id: dock1
            title: "我的面板"
            
            Rectangle {
                color: "lightblue"
                anchors.fill: parent
                Text {
                    text: "测试停靠面板"
                    anchors.centerIn: parent
                }
            }
        }
        
        Component.onCompleted: {
            dock1.addToMainWindow(mainWindow, KDDockWidgets.Location.Left)
        }
    }
}

3. 手动添加QML插件路径（按需）
   如果QML导入时报“找不到模块”，可在Python代码中手动指定插件路径：

import os
from PySide2.QtCore import QDir

# 获取kddockwidgets模块安装路径
kddw_path = os.path.dirname(kddockwidgets.__file__)
# 向QML引擎添加插件路径
engine.addImportPath(os.path.join(kddw_path, "qml"))

额外排查点 #

• 确保构建前激活了目标虚拟环境env，避免CMake使用系统Python而非虚拟环境版本
• 检查CMake配置阶段的输出日志，确认PySide2路径被正确识别，Python绑定生成配置无异常
• 确认使用的KDDockWidgets源码为2.0正式版本，避免使用开发分支导致兼容性问题

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