刘芷宁1. 问题现象与背景分析
最近在Qt5.11.0环境下开发时，遇到了一个让人抓狂的问题：QTableWidget的setColumnWidth()方法竟然完全不起作用！作为一个用了Qt多年的老手，我第一反应是"这怎么可能？"但反复测试后发现，在某些特定条件下，这个看似简单的API确实会失效。
这个问题特别容易出现在以下场景：
- 表格启用了水平表头（horizontalHeader）的交互功能
- 使用了setHorizontalHeaderLabels()设置列标题
- 在表格内容动态变化时尝试调整列宽
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 问题复现与排查过程
2.1 最小复现代码
先来看一个能100%复现问题的代码片段：
cpp复制QTableWidget *table = new QTableWidget(5, 3);
table->setHorizontalHeaderLabels({"列1", "列2", "列3"});
// 以下设置无效！
table->setColumnWidth(0, 200);
table->setColumnWidth(1, 150);
table->setColumnWidth(2, 100);
// 启用表头交互
table->horizontalHeader()->setSectionResizeMode(QHeaderView::Interactive);
2.2 排查思路
-
检查API文档：首先确认setColumnWidth()的官方文档，明确其设计用途是"设置给定列的宽度"，没有提到任何限制条件。
-
测试不同Qt版本：发现Qt5.11.0-5.12.3版本存在此问题，而Qt5.15.2表现正常。
-
分析QHeaderView源码：通过调试发现，当header的resizeMode设置为Interactive时，会覆盖setColumnWidth的设置。
3. 根因分析与解决方案
3.1 问题本质
根本原因在于QHeaderView的resizeMode优先级高于setColumnWidth。当设置为Interactive或Stretch时，表格会根据内容自动调整列宽，忽略手动设置的值。