Qt C++跨类访问静态变量遇链接报错，如何解决？

开发Qt Todo应用时，尝试在TaskManager类中访问ListManager类的静态成员listName以关联任务和列表，出现链接错误。Qt Creator和CppCheck无语法错误提示，但构建失败。

相关代码片段：

ListManager.h #

public:
    static QStringList listName;

ListManager.cpp #

void ListManager::on_pushButton_addList_clicked(){
    QString nameList = QInputDialog::getText(this, tr("Add list"), tr("List name"), QLineEdit::Normal, tr("Untitled list"), &ok);
    listName += nameList; // 保存列表名称到QStringList
}

TaskManager.cpp #

#include "listmanager.h"
// 其他代码
void ListManager::on_pushButton_addTask_clicked(){ // 注意：此处函数所属类错误，应为TaskManager
    QStringList listsNames = ListManager::listName;
    addTaskDialog.comboBox->addItems(listsNames);
}

构建时的链接错误：

error: Undefined symbols for architecture arm64:
  "ListManager::listName", referenced from:
      ListManager::on_pushButton_addList_clicked() in listmanager.o
      TaskManager::on_pushButton_addTask_clicked() in taskmanager.o
error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [ToDoApp.app/Contents/MacOS/ToDoApp] Error 1

1. 定义静态成员变量 #

C++中，类的静态成员变量仅在头文件中声明是不够的，必须在类外部（通常是对应的.cpp文件）定义，为其分配内存。

在ListManager.cpp的全局作用域（所有成员函数之外）添加以下代码：

QStringList ListManager::listName;

2. 修正TaskManager中的函数归属错误 #

你的TaskManager.cpp中，函数on_pushButton_addTask_clicked被错误地声明为ListManager的成员，这会导致编译错误。应修改为TaskManager的成员：

void TaskManager::on_pushButton_addTask_clicked(){
    QStringList listsNames = ListManager::listName;
    addTaskDialog.comboBox->addItems(listsNames);
}

原因说明 #

静态成员变量属于类本身，而非类的某个对象。头文件中的static QStringList listName;只是告诉编译器这个变量存在，但没有为它分配实际的内存空间。链接器在构建时找不到变量的实体，因此抛出"Undefined symbols"错误。通过在.cpp文件中定义静态成员，就能为其分配内存，解决链接问题。

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