1. QCursor基础：从标准光标到自定义形状

在Qt开发中，QCursor类就像鼠标的"造型师"，它决定了用户在不同场景下看到的鼠标外观。想象一下，当你在文本输入框看到竖线光标，在链接上看到小手图标，在等待时看到旋转的圆圈——这些都是QCursor的功劳。

Qt内置了21种标准光标形状，覆盖了绝大多数使用场景。比如：

• Qt::ArrowCursor：最常见的箭头光标
• Qt::IBeamCursor：文本输入时的竖线
• Qt::PointingHandCursor：可点击元素的小手
• Qt::WaitCursor：等待状态的沙漏或旋转圆圈

创建标准光标非常简单：

// 使用预定义形状
QCursor arrowCursor(Qt::ArrowCursor);
QCursor waitCursor(Qt::WaitCursor);

// 为控件设置光标
myWidget->setCursor(arrowCursor);

但真正的魔法在于自定义光标。通过QPixmap或QBitmap，你可以创造任何形状的光标——公司Logo、特殊图标，甚至是动态GIF转换的动画光标。关键参数是热点(hotspot)，它决定了光标的"点击点"，就像箭头尖端的那个像素。

2. 深度自定义：从静态到动态光标的进阶技巧

2.1 基于QPixmap创建自定义光标

QPixmap方式是最直观的自定义方法，支持透明度和彩色图像。假设我们想用一个红色靶心作为光标：

QPixmap targetPixmap(32, 32);
targetPixmap.fill(Qt::transparent); // 透明背景

QPainter painter(&targetPixmap);
painter.setPen(QPen(Qt::red, 3));
painter.drawEllipse(5, 5, 22, 22); // 外圆
painter.drawLine(16, 0, 16, 32);   // 垂直线
painter.drawLine(0, 16, 32, 16);   // 水平线

// 创建光标，热点在中心(16,16)
QCursor targetCursor(targetPixmap, 16, 16);

实际项目中我遇到过一个问题：在高DPI屏幕上，32x32的光标会显得太小。解决方案是创建多尺寸版本：

QPixmap highDPIPixmap(64, 64);
// ...绘制逻辑...
highDPIPixmap.setDevicePixelRatio(2.0); // 适配200%缩放

2.2 使用QBitmap实现精确控制

当需要精确控制每个像素时，QBitmap是更好的选择。它使用1位深度，通过黑白位图定义形状，再用掩码(mask)定义透明度：

// 定义光标形状 (X表示黑色像素)
const char cursorShape[] = {
    "X               ",
    "XX              ",
    "X.X             ",
    "X..X            ",
    "X...X           ",
    "X....X          ",
    "X.....X         ",
    "X......X        ",
    "X.......X       ",
    "X........X      ",
    "X.....XXXXX     ",
    "X..X..X         ",
    "X.X X..X        ",
    "XX  X..X        ",
    "X    X..X       ",
    "     XXXX       "
};

QBitmap bitmap = QBitmap::fromData(QSize(16, 16), 
    reinterpret_cast<const uchar*>(cursorShape));

// 创建全不透明的掩码
QBitmap mask(16, 16);
mask.fill(Qt::color1);

QCursor customCursor(bitmap, mask, 0, 0); // 热点在左上角

2.3 实现动态光标效果

通过定时器可以创建简单的动画光标。比如实现一个旋转的加载光标：

class AnimatedCursor : public QObject {
    Q_OBJECT
public:
    AnimatedCursor(QWidget *parent) : QObject(parent), angle(0) {
        timer = new QTimer(this);
        connect(timer, &QTimer::timeout, this, &AnimatedCursor::updateCursor);
        timer->start(50); // 20FPS
    }

private slots:
    void updateCursor() {
        QPixmap pixmap(32, 32);
        pixmap.fill(Qt::transparent);
        
        QPainter painter(&pixmap);
        painter.translate(16, 16);
        painter.rotate(angle);
        painter.drawRect(-2, -10, 4, 20);
        
        angle = (angle + 10) % 360;
        parent()->setCursor(QCursor(pixmap, 16, 16));
    }

private:
    QTimer *timer;
    int angle;
};

3. 跨平台适配：解决Windows/macOS/Linux的显示差异

3.1 平台差异对照表

特性	Windows	macOS	Linux(X11)
最大尺寸	32x32(传统), 支持更大	128x128	64x64
色彩支持	全彩+Alpha	全彩+Alpha	依赖Xcursor库
动画支持	有限	优秀	依赖Xcursor库
热点精度	像素级	像素级	像素级
HiDPI支持	需要多尺寸	自动适配	依赖主题

3.2 Windows平台特别处理

在Windows上，超过32x32的光标需要特殊处理才能正常显示。实测发现以下方法有效：

#ifdef Q_OS_WIN
    if (pixmap.width() > 32 || pixmap.height() > 32) {
        // Windows传统API限制，需要转换为特殊格式
        pixmap = pixmap.scaled(32, 32, Qt::KeepAspectRatio);
    }
#endif

3.3 macOS的Retina适配

macOS对高DPI光标的支持最好，但需要注意：

QPixmap pixmap;
if (qApp->devicePixelRatio() > 1.0) {
    pixmap = QPixmap("cursor@2x.png");
    pixmap.setDevicePixelRatio(2.0);
} else {
    pixmap = QPixmap("cursor.png");
}

3.4 Linux/X11的Xcursor集成

在Linux上，最佳实践是同时提供Xcursor主题文件：

# 在应用目录创建cursor-theme目录
myapp/
└── cursor-theme/
    ├── index.theme
    └── cursors/
        ├── my-cursor
        └── my-cursor.png

index.theme内容示例：

[Icon Theme]
Name=MyApp Cursors
Comment=Custom cursors for MyApp

然后在代码中加载：

if (qApp->platformName().contains("xcb")) {
    qputenv("XCURSOR_PATH", 
        QCoreApplication::applicationDirPath().toLocal8Bit() + "/cursor-theme");
    qputenv("XCURSOR_THEME", "MyApp Cursors");
}

4. 实战避坑指南：版本兼容与性能优化

4.1 处理API变更

Qt 5.15开始，bitmap()和mask()的返回值行为发生了变化。兼容写法应该是：

// 兼容所有Qt版本的写法
QCursor cursor;
QBitmap bitmap;

#if QT_VERSION < QT_VERSION_CHECK(5, 15, 0)
    bitmap = *cursor.bitmap(); // 旧版本返回指针
#else
    bitmap = cursor.bitmap(Qt::ReturnByValue); // 新版本
#endif

4.2 内存管理最佳实践

自定义光标可能成为内存泄漏的重灾区。我踩过的坑：

1. 不要重复创建：对于频繁使用的光标，应该缓存QCursor对象

// 错误做法：每次调用都创建新对象
void setBusyCursor() {
    widget->setCursor(QCursor(Qt::WaitCursor));
}

// 正确做法：静态缓存
void setBusyCursor() {
    static QCursor waitCursor(Qt::WaitCursor);
    widget->setCursor(waitCursor);
}

2. 注意QPixmap的生命周期：确保光标使用的QPixmap在光标存活期间不被销毁

4.3 性能优化技巧

• 预加载所有光标：在应用启动时创建所有需要的光标，避免运行时开销
• 使用共享指针：对于复杂光标，考虑使用QSharedPointer管理资源

QSharedPointer<QPixmap> cursorPixmap(new QPixmap("complex-cursor.png"));
QCursor cursor(*cursorPixmap);
// 只要cursor存在，pixmap就不会被释放

• 避免频繁切换：批量处理光标变更，减少setCursor调用次数

4.4 调试技巧

当光标显示异常时，可以检查以下信息：

qDebug() << "Current cursor shape:" << cursor.shape();
qDebug() << "Pixmap is null:" << cursor.pixmap().isNull();
qDebug() << "Hotspot:" << cursor.hotSpot();

对于跨平台问题，我通常会创建一个测试窗口显示所有��定义光标：

void CursorTestWindow::paintEvent(QPaintEvent *) {
    QPainter painter(this);
    int y = 10;
    for (const auto &cursor : cursors) {
        painter.drawPixmap(10, y, cursor.pixmap());
        painter.drawText(50, y + 20, cursor.name());
        y += 50;
    }
}

在真实项目中，我们曾遇到Linux系统上自定义光标显示为黑色方块的问题。最终发现是X服务器未正确加载alpha通道。解决方案是强制使用ARGB格式：

QPixmap pixmap = ...;
pixmap = pixmap.convertToFormat(QImage::Format_ARGB32);