Qt开发创建表格时提示‘TableViewColumn is not a type’错误求助

你的问题出在Qt Quick Controls 2.x与1.x的API差异：TableViewColumn是Qt Quick Controls 1.x中的组件，而你当前导入的是Qt Quick Controls 2.15，这一套API里已经不再使用TableViewColumn来定义表格列了。

正确的Qt6（Controls 2）表格实现方式 #

替换你的Main.qml代码为以下内容，用Controls 2的标准写法实现表格：

import QtQuick 2.15
import QtQuick.Controls 2.15

TableView {
    id: tableView
    width: 400
    height: 300

    // 定义列配置数组
    columns: [
        TableViewColumn {
            role: "name"
            title: "Name"
            width: 200
        },
        TableViewColumn {
            role: "age"
            title: "Age"
            width: 100
        }
    ]

    // 定义单元格渲染委托
    delegate: Text {
        width: tableView.columnWidthProvider(column)
        text: model[tableView.columns[column].role]
        anchors.centerIn: parent
    }

    model: ListModel {
        ListElement { name: "Alice"; age: 30 }
        ListElement { name: "Bob"; age: 25 }
    }
}

错误原因说明 #

Qt Quick Controls 2重新设计了TableView的架构：

• 不再直接将TableViewColumn作为TableView的子项，而是需要将列配置放在columns数组中
• 必须手动指定delegate来渲染每个单元格内容（Controls 1的TableView会自动处理渲染逻辑，Controls 2需要自定义）

备选方案（不推荐）：切换到Controls 1.x #

如果你一定要沿用TableViewColumn的旧写法，可以修改导入语句切换到Controls 1.x：

import QtQuick 2.15
import QtQuick.Controls 1.4 // 改用Controls 1.x版本

TableView {
    id: tableView
    width: 400
    height: 300

    TableViewColumn {
        role: "name"
        title: "Name"
        width: 200
    }

    TableViewColumn {
        role: "age"
        title: "Age"
        width: 100
    }

    model: ListModel {
        ListElement { name: "Alice"; age: 30 }
        ListElement { name: "Bob"; age: 25 }
    }
}

但这种方式不推荐，因为Controls 1处于维护状态，Qt6对其支持有限，未来可能被移除。

你的CMakeLists.txt配置没有问题，已经正确链接了Qt6::QuickControls2，只需要修改QML代码即可解决问题。

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