Qt-Advanced-Docking-System实战：5分钟搞定VS风格IDE窗口布局（附完整代码）

最新推荐文章于 2026-03-05 00:11:16 发布

原创

最新推荐文章于 2026-03-05 00:11:16 发布 · 191 阅读

Qt-Advanced-Docking-System实战：5分钟搞定VS风格IDE窗口布局（附完整代码）

如果你正在用Qt开发一款桌面应用，尤其是那种需要复杂界面布局的工具——比如代码编辑器、数据分析软件或者CAD系统——那你一定对窗口管理这个“老大难”问题深有体会。Qt自带的QDockWidget用起来总感觉差点意思：拖拽生硬、布局不够灵活，想做出像Visual Studio或者Qt Creator那样丝滑的停靠体验，往往需要自己写一大堆胶水代码，最后还容易出各种奇怪的bug。

几年前我接手一个数据可视化平台项目时，就卡在了窗口布局上。用户希望每个图表、每个控制面板都能自由拖拽、组合、甚至浮动成独立窗口，还要能保存布局。当时试了好几个方案，要么功能不全，要么稳定性堪忧，直到发现了Qt-Advanced-Docking-System（QADS）。这个开源库几乎完美复刻了现代IDE的窗口管理逻辑，而且集成起来异常简单。我记得当时只用了不到一个下午，就把原来那套蹩脚的自研布局系统替换掉了，效果立竿见影。

今天这篇文章，我就带你快速上手QADS。我会从一个最精简的示例开始，一步步演示如何用5分钟搭建起一个功能完整的VS风格界面。我们不仅会覆盖基础集成，还会深入几个实战中高频使用的“骚操作”，比如自定义样式、处理动态窗口、以及布局持久化。文末我会附上一个可以直接编译运行的完整项目代码，你可以拿来即用，或者作为自己项目的起点。

1. 环境准备与项目集成

在开始写代码之前，我们得先把QADS库弄到你的项目里。别担心，这个过程比想象中简单得多。

1.1 获取源码与依赖

QADS是一个纯头文件和源文件组成的库，不依赖任何第三方二进制文件。获取它的方式主要有两种：

直接下载源码包：访问其GitHub仓库（github.com/githubuser0xFFFF/Qt-Advanced-Docking-System），下载最新的release压缩包。解压后，你会看到src目录，里面就是所有需要的.h和.cpp文件。
使用Git子模块：如果你的项目本身就用Git管理，我更推荐这种方式，便于后续更新。

# 在你的项目根目录下执行
git submodule add https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System.git 3rdparty/ads

无论哪种方式，最终你都需要把src目录下的所有文件添加到你的Qt项目中。QADS本身只依赖Qt的Core、Gui和Widgets模块，这些都是Qt Widgets应用的基础，你的项目肯定已经包含了。

注意：QADS完美支持Qt5和Qt6。如果你用的是Qt6，确保你拉取的是支持Qt6的分支或版本。从4.0版本开始，官方已经提供了良好的Qt6兼容性。

1.2 集成到Qt项目（.pro文件）

假设你有一个标准的Qt Widgets Application项目，使用.pro文件管理。集成QADS只需要几行配置。

首先，把你下载或克隆的QADS源码目录（假设是3rdparty/ads）复制到你的项目目录下。然后，打开你的.pro文件，添加以下内容：

# 包含QADS的源文件和头文件
include(3rdparty/ads/src/ads.pri)

# 如果你的Qt版本是5.15或更高，或者使用的是Qt6，可能需要显式开启C++17
# CONFIG += c++17

那个ads.pri文件是库作者写好的，它会自动帮你把正确的头文件路径和源文件添加到编译过程中。保存.pro文件，然后执行qmake并重新构建你的项目。如果没有报错，恭喜你，集成成功了。

如果你用的是CMake，过程也类似，通过add_subdirectory()引入即可。

# 在你的CMakeLists.txt中
add_subdirectory(3rdparty/ads)
target_link_libraries(YourTargetName PRIVATE ads::ads)

1.3 创建主窗口骨架

我们先创建一个最基础的MainWindow类，作为我们演示的舞台。这个窗口暂时是空的，我们下一步会把QADS的核心管理器放进去。

// mainwindow.h
#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

// 前向声明，避免头文件污染
namespace ads {
    class CDockManager;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    // QADS的核心管理类，所有停靠窗口都由它管理
    ads::CDockManager* m_dockManager = nullptr;
};

#endif // MAINWINDOW_H

头文件很简单，就是声明了一个CDockManager的指针。接下来看实现。