From 2f06b3722e1a538f92a471299359c878093cc58c Mon Sep 17 00:00:00 2001
From: sunlei <yemu2333@outlook.com>
Date: Fri, 5 Jun 2026 09:17:48 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BF=AE=E5=A4=8D=E5=AD=97=E5=85=B8?=
 =?UTF-8?q?=E7=BC=96=E7=A0=81=E8=A1=A8=E6=A0=BC=E5=88=97=E5=AE=BD=E6=BA=A2?=
 =?UTF-8?q?=E5=87=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ktTable/hooks/useKtTableColumns.ts        | 43 +++++++++++++++----
 1 file changed, 34 insertions(+), 9 deletions(-)

diff --git a/apps/web-antdv-next/src/components/ktTable/hooks/useKtTableColumns.ts b/apps/web-antdv-next/src/components/ktTable/hooks/useKtTableColumns.ts
index 5bbe067..0c572db 100644
--- a/apps/web-antdv-next/src/components/ktTable/hooks/useKtTableColumns.ts
+++ b/apps/web-antdv-next/src/components/ktTable/hooks/useKtTableColumns.ts
@@ -33,6 +33,11 @@ type ColumnResizeHandler = (
     };
   },
 ) => void;
+type ColumnWidthEntry = {
+  column: TableColumnType<KtTableRecord>;
+  key: string;
+  width: number;
+};
 
 /**
  * 管理 KtTable 的列顺序、列显隐、列宽拖拽和横向滚动宽度。
@@ -92,12 +97,13 @@ export function useKtTableColumns(options: UseKtTableColumnsOptions) {
   });
   const tableRenderWidth = computed(() => {
     const hasFlexibleColumns = visibleSourceColumns.value.length > 0;
+    const viewportWidth = tableViewportWidth.value;
 
     if (!hasFlexibleColumns) {
       return rawTableWidth.value;
     }
 
-    return Math.max(rawTableWidth.value, tableViewportWidth.value, 720);
+    return Math.max(rawTableWidth.value, Math.max(viewportWidth, 0));
   });
   const tableScrollX = computed(() => {
     const viewportWidth = tableViewportWidth.value;
@@ -297,15 +303,22 @@ export function useKtTableColumns(options: UseKtTableColumnsOptions) {
     const map = new Map<string, number>();
     if (surplusWidth <= 0) return map;
 
-    const entries = sourceColumns
-      .map((column) => ({
-        key: getColumnKey(column),
+    const dataColumnEntries: ColumnWidthEntry[] = [];
+    for (const column of sourceColumns) {
+      const key = getColumnKey(column);
+      if (!key || isFixedSystemColumn(key)) continue;
+
+      dataColumnEntries.push({
+        column,
+        key,
         width: getColumnRenderWidth(column),
-      }))
-      .filter(
-        (entry): entry is { key: string; width: number } =>
-          !!entry.key && !isFixedSystemColumn(entry.key),
-      );
+      });
+    }
+    const flexibleEntries = dataColumnEntries.filter(
+      (entry) => !hasExplicitColumnWidth(entry.column),
+    );
+    const entries =
+      flexibleEntries.length > 0 ? flexibleEntries : dataColumnEntries;
     const totalWidth = entries.reduce((total, entry) => total + entry.width, 0);
     if (totalWidth <= 0) return map;
 
@@ -327,6 +340,18 @@ export function useKtTableColumns(options: UseKtTableColumnsOptions) {
     );
   }
 
+  /**
+   * 判断业务列是否显式声明了宽度。显式宽度代表业务侧希望该列保持稳定，
+   * 宽屏剩余空间优先留给未声明宽度的弹性列。
+   *
+   * @param column 当前表格列配置。
+   */
+  function hasExplicitColumnWidth(column: TableColumnType<KtTableRecord>) {
+    const { width } = column;
+
+    return width !== undefined && width !== null && width !== '';
+  }
+
   /**
    * 创建业务列列宽拖拽处理器，系统列固定宽度所以不返回处理器。
    *