cloud-web-corejs 1.0.282 → 1.0.283

package/src/components/xform/docs/2026-09 /347/274/226/350/276/221/350/241/250/350/241/214/345/206/205/344/277/235/345/255/230/346/240/241/351/252/214/350/214/203/345/233/264/344/270/216/345/210/227/345/277/205/345/241/253/350/247/243/346/236/220/344/277/256/345/244/215.md"

@@ -0,0 +1,233 @@
+# 编辑表行内保存的校验范围 & 列必填解析 —— 修复文档（2026-09-03）
+
+> 状态：**两项均已编码 + 单测过，待联调**。
+> 改动文件：`src/components/xform/form-render/container-item/data-table-mixin.js`、
+> `src/components/xform/utils/tableColumnHelper.js`。
+> 新增单测：`tests/unit/components/xform/editRowValidateScope.spec.js`（6 条）、
+> `tests/unit/components/xform/columnRequiredFlag.spec.js`（7 条）。
+> 行号均为 2026-09-03 工作区快照，后续会漂移，以函数名为准。
+> 同步：dev 与 stdxx 两分支均**未搬**。
+
+---
+
+## 一、两个问题
+
+| # | 现象 | 根因一句话 |
+|---|------|-----------|
+| A | 编辑（树）表点行内保存 ✓，别的行缺必填、甚至表格外的字段没填，都会把这一行的保存拦住 | `saveEditRow` 走的是整表 + 全表单的 `formRef.validate` |
+| B | 某列 `required` 与 `editWidget.options.required` 都是 `false`，运行起来却必填（表头星号 + 拦保存） | 列在设计器里配过展示组件后又改回空，残留的 `columnOption.required` 仍被 `resolveColumnRequiredFlag` 无条件读取 |
+
+两者独立，但都落在"必填校验"这条线上，一起记。
+
+---
+
+## 二、问题 A：行内保存跑了全表校验
+
+### 2.1 原链路
+
+```
+data-table-item.vue  #editTreeButtonGroup 插槽的「保存」a-link
+  → saveEditRow(obj)                                   [data-table-mixin.js:4469]
+      → formRef.validate(resolve)                      ← 整表 + 表外字段
+          → el-form.$baseValidate                      原生规则（只覆盖已渲染的 form-item）
+          → runExtraFormValidations()                  [indexMixin.js:3862]
+              ├─ validateArrayValueFieldsRequired()    全表单数组类值字段
+              ├─ validateDataTableCellsRequired()      **每个数据表格逐行**必填
+              └─ validateDataTableDatasetRequired()    数据表整体必填
+      → $baseConfirm → clearActived/setActiveRow → formHttp（只发当前行）
+```
+
+保存粒度是**行**（`requestRow = obj.row`，报文里只有这一行），校验粒度却是**整表单**。
+
+### 2.2 改动
+
+`validateCellsRequired` 抽出核心循环，让"校验哪些行"与"prop 里的行下标"分离：
+
+```js
+// data-table-mixin.js:1045
+validateCellsRequired() {
+  ...
+  return this.runCellsRequiredCheck(rows, rows);   // 整体保存：全表逐行
+},
+// data-table-mixin.js:1063
+runCellsRequiredCheck(targetRows, indexRows) { ... }
+```
+
+- `targetRows` —— 本次要校验的行；
+- `indexRows` —— 求行下标用的**完整数据集**。
+  单行校验时**必须**传全量数据集，否则 `getValidationRowIndex` 拿到的是 0，
+  拼出来的 `items.0.f_code` 会定位到错误的行。
+
+新增三个方法：
+
+| 方法 | 位置 | 职责 |
+|------|------|------|
+| `validateEditRowRequired(row)` | `data-table-mixin.js:1130` | 只对该行跑必填（内部 `runCellsRequiredCheck([row], 全量)`） |
+| `collectRowValidateProps(row)` | `data-table-mixin.js:1141` | 收该行的单元格 prop，按真实行下标拼，并**按 `renderForm.fields` 过滤掉未注册的** |
+| `validateEditRow(row)` | `data-table-mixin.js:1184` | 入口：原生规则 → 必填兜底，任一失败弹消息返回 false |
+
+`saveEditRow` 的第一步随之改为：
+
+```js
+// 行内保存只提交当前行，校验范围同步收敛到当前行：其他行与表外字段
+// 的必填不该拦住单行保存（整体保存仍走 formRef.validate 的全量校验）
+if (!this.validateEditRow(obj.row)) return false;
+```
+
+### 2.3 行为对照
+
+| 通道 | 原生规则（正则 / 自定义 validator） | 必填 |
+|------|--------------------------------|------|
+| 整体保存（`formRef.validate`） | 全表单已渲染的 form-item | 全表逐行 + 数据集必填 + 数组类字段 |
+| 行内保存（`validateEditRow`） | **仅当前行**已注册的 prop | **仅当前行** |
+
+### 2.4 两个坑（已在实现里处理）
+
+1. **prop 必须先按 `renderForm.fields` 过滤**。element 的 `validateField(props, cb)` 在传入的 prop
+   一个都没注册时会打 `[Element Warn] please pass correct props!`。编辑表用的是
+   vxe `editConfig: { trigger: "manual", mode: "row" }`，`edit` 插槽只在**正在编辑的那一行**渲染，
+   未编辑行的 prop 本就不在 `fields` 里。
+2. **`getValidationRows` 读的是 computed `fieldKeyName`**，不是 `getFieldKeyName(this.widget)`。
+   写单测造上下文时必须直给 `fieldKeyName`，否则会掉进 `$grid.getTableData()` 兜底分支。
+
+---
+
+## 三、问题 B：残留 `columnOption` 让列凭空必填
+
+### 3.1 判据
+
+问题列的模板 JSON（节选）：
+
+| 位置 | 值 |
+|------|-----|
+| 列级 `required` | `false` |
+| `formatS` / `widget` | `""` / `null` ← 展示组件已改回空 |
+| `editFormatS` / `editWidget.options.required` | `"editInput"` / `false` |
+| **`columnOption.required`** | **`true`** ← 残留快照 |
+
+### 3.2 根因：两条读取路径口径不一致
+
+| 路径 | 读什么 | 结果 |
+|------|--------|------|
+| 加载时 `applyColumnMetaToFieldWidget`（`util.js:919`，由 `handleTableColumnWidget`（`indexMixin.js:674`）调用） | **只读对应侧**：编辑侧读 `editWidgetOptions ?? editColumnOption` | `editWidget.options.required` = `false` ✅ |
+| 运行时 `resolveColumnRequiredFlag`（`tableColumnHelper.js:90`） | 改动前**两侧都读、且不看 `formatS`**：`widgetOptions ?? columnOption` | `true` ❌ |
+
+该 flag 有**两个出口**，所以现象是"星号 + 拦保存"一起来：
+
+- `applyColumnLabelIcon`（`tableColumnHelper.js:126`）→ 表头画 `vxe-cell--required-icon`；
+- `isCellFieldRequired`（`tableCellValidateUtil.js:52`）→ 组件自身 `required` 为 false 时**落到**该 flag → 进必填校验。
+
+### 3.3 改动
+
+新增两个内部函数，给静态列的列级 option 加门控：
+
+```js
+// tableColumnHelper.js:12
+function hasColumnWidgetSide(columnConfig, isEdit) {
+  if (isEdit) {
+    return !!(columnConfig.editWidget || columnFormatMap[columnConfig.editFormatS]);
+  }
+  return !!(columnConfig.widget || columnFormatMap[columnConfig.formatS]);
+}
+// tableColumnHelper.js:32
+function getEffectiveColumnOptions(columnConfig, isEdit) { ... }
+```
+
+`resolveColumnRequiredFlag` 的兜底改为：
+
+```js
+const widgetOptions = getEffectiveColumnOptions(columnConfig, false);
+const editWidgetOptions = getEffectiveColumnOptions(columnConfig, true);
+return !!(widgetOptions?.required || editWidgetOptions?.required);
+```
+
+口径：
+
+- **动态列**的 `widgetOptions` / `editWidgetOptions` 直接生效（它们本就没有 `formatS`，不门控）；
+- **设计器静态列**的 `columnOption` / `editColumnOption` 只在该侧
+  `columnFormatMap[formatS]` 能映射出组件类型（或 widget 已实例化）时才读。
+
+**门控判据必须用 `columnFormatMap`，不能用"`formatS` 非空"** —— 纯格式化列（`formatS: "d1"` 这类格式码）
+同样不建 widget，那份残留 option 也不该作数；用 `columnFormatMap` 才与加载时的实例化口径完全一致。
+
+### 3.4 排除项：展示态不会被误渲染成组件
+
+展示侧组件的实例化在三条路径上都以 `columnFormatMap[formatS]` 为门：
+
+| 路径 | 位置 |
+|------|------|
+| 运行态 | `form-render/indexMixin.js:690` |
+| 设计器 | `form-designer/form-widget/container-widget/data-table-mixin.js:220` |
+| H5 列表 | `form-render/container-item/list-h5-item.vue:1692` |
+
+`formatS` 为空 → widget 保持 null → `createColumn` 的展示插槽 if 链（`data-table-mixin.js:2158`）
+一条都不命中 → 单元格走 `formatter: formatterValue` 纯文本。
+`addColumProperty`（`data-table-mixin.js:2011`）展开的 `columnOption` 取自 **widget 实例**的 options，
+不是 JSON 里那份残留。
+
+所以残留 `columnOption` 在改动前唯一漏出来的地方就是 `resolveColumnRequiredFlag` ——
+全仓读 `columnOption` 的点里只有它不看 `formatS`。
+
+### 3.5 老数据不做清理
+
+渲染路径对这类残留**只有补齐、没有校验、也没有清理**：`handleTableColumnWidget` 是单向的
+（`formatS` 映射得出组件才建 widget），不会比对"widget 不存在但 columnOption 还在"，
+全仓也没有任何删除 `columnOption` 的写法；设计器侧 `cloneTableColumnsForEdit`
+（`table-column-dialog.vue:1107`）还会在 `!row.widget` 时把它深拷贝带进编辑态再写回模板。
+
+结论：**DB 里的残留不必清** —— 代码侧已经兜住，清理反而要动存量模板。
+若要早发现，最轻的一档是在 `handleTableColumnWidget` 里对
+"该侧无组件却带着 columnOption"仅开发环境 `console.warn`（未实施）。
+
+---
+
+## 四、改动清单
+
+| 文件 | 改动 |
+|------|------|
+| `form-render/container-item/data-table-mixin.js` | `validateCellsRequired` 抽出 `runCellsRequiredCheck(targetRows, indexRows)`；新增 `validateEditRowRequired` / `collectRowValidateProps` / `validateEditRow`；`saveEditRow` 首步由 `formRef.validate` 换成 `validateEditRow(obj.row)` |
+| `utils/tableColumnHelper.js` | 新增 `hasColumnWidgetSide` / `getEffectiveColumnOptions`（并 `import { columnFormatMap } from "./util"`）；`resolveColumnRequiredFlag` 兜底改走门控 |
+| `tests/unit/components/xform/editRowValidateScope.spec.js` | 新增，6 条 |
+| `tests/unit/components/xform/columnRequiredFlag.spec.js` | 新增，7 条 |
+
+未改动、行为保持不变：`validateForm` / `validate` / `runExtraFormValidations` 三个整体保存入口，
+`validateCheckRow`（勾选行操作的行级校验），H5 列表的必填口径（只读列级 `t.required`）。
+
+---
+
+## 五、验证
+
+- `npx jest tests/unit/components/xform` —— 28 套全过（含两个新增 spec）。
+- `npx jest tests/unit/components` —— 49 套 712 条，711 通过；唯一失败
+  `mobile/h5PopDialog.spec.js`（`selectUserDialog.vue` 缺 `custom-class="h5-pop-dialog"`）
+  属 H5 wf 弹层那条线的既有状态，**与本次改动无关**。
+- eslint：`data-table-mixin.js` 无新增报错（51 条 operator-linebreak 均为既有欠账，
+  行号不落在新增段）；`tableColumnHelper.js` 由 4 条降至 2 条。
+
+单测覆盖点：
+
+| spec | 覆盖 |
+|------|------|
+| editRowValidateScope | 整体保存仍全表拦 / 别的行缺必填不拦当前行 / 当前行自己缺必填仍拦 / prop 带真实行下标且只发当前行 / 未注册 prop 不下发 / 原生错优先于必填兜底 |
+| columnRequiredFlag | 残留 columnOption 不再必填 / 老数据（formatS 有值、widget 未实例化）仍必填 / 纯格式化列不读 / editColumnOption 按 editFormatS 门控 / 动态列不受门控 / 列级与实例 required 照旧 / 空配置 |
+
+---
+
+## 六、影响面与联调点
+
+| 变更 | 影响面 | 联调重点 |
+|------|--------|----------|
+| A | 仅编辑树表的 `editTreeButtonGroup` 行内保存 | 当前行必填仍拦、错误能定位到该行；他行/表外字段缺失不再误拦；原生正则规则在当前行仍生效 |
+| B | 全量表格的必填标记（表头星号）与单元格必填校验 | 抽查若干正常配置的必填列，星号与校验都还在；问题列星号消失、不再拦保存 |
+
+B 的潜在风险：若有表单**依赖**这份残留 `columnOption.required` 来实现必填（即列级和组件级都没配、
+全靠残留生效），改后会变成非必填。属于"配置本就不合规"的情况，联调时留意用户反馈的
+"某列突然不必填了"，正解是去列配置或组件上把 required 补回。
+
+---
+
+## 七、待办
+
+1. 真机联调（两项均未联调）。
+2. **同步 dev 与 stdxx 两分支**（按既有同步规则：JS 可整体覆盖、样式不覆盖）。
+3. 可选：`handleTableColumnWidget` 的 dev-only `console.warn`（残留列级 option 早发现），未实施。

package/src/components/xform/form-designer/form-widget/dialog/importDialogMixin.js

@@ -8,6 +8,14 @@ let XLSX = window.XLSX || { read, utils };
 import { getToken } from "../../../../../utils/auth";
 import XEUtils from "xe-utils";
 import { getErrorMsg } from "@base/utils/index.js";
+import {
+  getImportCellText,
+  getImportFileSizeLimit,
+  getImportRowLimit,
+  isImportFileOversize,
+  isImportRowsOverLimit,
+  toFileSizeMb,
+} from "../../../../../utils/importLimit";
 
 let configUtil = {
   baseUrl: process.env.VUE_APP_BASE_API,
@@ -372,6 +380,25 @@ tmixins = {
       let that = this;
       let option = this.option;
 
+      // 业务侧的 importFileLimitSize 允许到 200MB，而这里是整文件 readAsBinaryString +
+      // XLSX.read 同步解析，占用约为文件体积的 5~20 倍 —— 那个量级必然把标签页撑爆，
+      // 且崩在库内部，连提示都给不出来。这里再收一道解析安全上限，可用
+      // importOption.maxFileSize 覆盖（0 表示不限制）。
+      if (isImportFileOversize(file, option)) {
+        this.$baseAlert(
+          this.$t1(
+            "导入文件过大（{size}MB），当前最多支持 {limit}MB，请拆分后分批导入",
+            {
+              size: toFileSizeMb(file.size),
+              limit: toFileSizeMb(getImportFileSizeLimit(option)),
+            }
+          )
+        );
+        // 与上游那道 importFileLimitSize 校验保持一致：只提示、不关弹窗，
+        // 用户可以直接重选一个小文件。
+        return false;
+      }
+
       if (option.importOption.multipleSheet) {
         this.readExcel2(file, callback);
         return;
@@ -403,6 +430,22 @@ tmixins = {
           let range = configUtil.XLSX.utils.decode_range(sheet["!ref"]);
           let dataSize = range.e.r + 1; //行数
           that.dataSize = dataSize - 3 >= 0 ? dataSize - 3 : 0;
+          // 行数闸门：下面逐格取值、建行对象、再整批发包全是同步的，行数失控时主线程会被
+          // 占死甚至 OOM。文件体积不大但行极多（窄表）时只有这一道能拦。
+          if (isImportRowsOverLimit(that.dataSize, option)) {
+            that.clearImportTimer();
+            that.$baseAlert(
+              that.$t1(
+                "导入数据 {size} 行，超过单次上限 {limit} 行，请拆分后分批导入",
+                {
+                  size: that.dataSize,
+                  limit: getImportRowLimit(option),
+                }
+              )
+            );
+            that.handleClose2();
+            return false;
+          }
           let titles = [];
           let fields = [];
 
@@ -428,7 +471,7 @@ tmixins = {
               if (typeof nextCell === "undefined") {
                 row.push(void 0);
               } else {
-                row.push(nextCell.w.trim());
+                row.push(getImportCellText(nextCell));
               }
             }
             if (rowNum === 1) {
@@ -1483,6 +1526,22 @@ tmixins = {
             let range = configUtil.XLSX.utils.decode_range(sheet["!ref"]);
             let dataSize = range.e.r + 1; //行数
             that.dataSize = dataSize - 3 >= 0 ? dataSize - 3 : 0;
+            // 行数闸门：下面逐格取值、建行对象、再整批发包全是同步的，行数失控时主线程会被
+            // 占死甚至 OOM。文件体积不大但行极多（窄表）时只有这一道能拦。
+            if (isImportRowsOverLimit(that.dataSize, option)) {
+              that.clearImportTimer();
+              that.$baseAlert(
+                that.$t1(
+                  "导入数据 {size} 行，超过单次上限 {limit} 行，请拆分后分批导入",
+                  {
+                    size: that.dataSize,
+                    limit: getImportRowLimit(option),
+                  }
+                )
+              );
+              that.handleClose2();
+              return false;
+            }
             let titles = [];
             let fields = [];
 
@@ -1508,7 +1567,7 @@ tmixins = {
                 if (typeof nextCell === "undefined") {
                   row.push(void 0);
                 } else {
-                  row.push(nextCell.w.trim());
+                  row.push(getImportCellText(nextCell));
                 }
               }
               if (rowNum === 1) {

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -1051,6 +1051,16 @@ modules = {
         return null;
       }
 
+      return this.runCellsRequiredCheck(rows, rows);
+    },
+    /**
+     * 逐单元格必填校验的核心循环。
+     * @param {Array} targetRows 本次要校验的行。
+     * @param {Array} indexRows 求行下标用的完整数据集（决定校验 prop 里的行下标）。
+     * @returns {String|null} 首个错误提示，全部通过返回 null。
+     */
+    runCellsRequiredCheck(targetRows, indexRows) {
+      const rows = indexRows || [];
       const isEditTable = this.widget.options.isEditTable || false;
       const tableColumns = this.widget.options.tableColumns || [];
       const tableFieldKeyName = this.getFieldKeyName(this.widget);
@@ -1060,8 +1070,8 @@ modules = {
         this.collectColumnValidateEntries(column, isEditTable, columnEntries);
       });
 
-      for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
-        const row = rows[rowIndex];
+      for (let rowIndex = 0; rowIndex < targetRows.length; rowIndex++) {
+        const row = targetRows[rowIndex];
         if (!row) {
           continue;
         }
@@ -1112,6 +1122,87 @@ modules = {
 
       return null;
     },
+    /**
+     * 行内保存用：只校验当前行的必填，不牵动其他行。
+     * @param {Object} row 当前行。@returns {String|null} 错误提示，通过为 null。
+     */
+    validateEditRowRequired(row) {
+      if (!row || this.widget.options.hidden || this.designState) {
+        return null;
+      }
+      const rows = this.getValidationRows();
+      return this.runCellsRequiredCheck([row], rows.length ? rows : [row]);
+    },
+    /**
+     * 收集当前行所有参与校验的单元格 prop（用于原生规则的行级校验）。
+     * @param {Object} row 当前行。@returns {Array<String>} 已在表单里注册的 prop 列表。
+     */
+    collectRowValidateProps(row) {
+      const formRef = this.getFormRef?.();
+      const renderForm = formRef?.$refs?.renderForm;
+      if (!row || !renderForm) {
+        return [];
+      }
+      const isEditTable = this.widget.options.isEditTable || false;
+      const tableColumns = this.widget.options.tableColumns || [];
+      const tableFieldKeyName = this.getFieldKeyName(this.widget);
+      const rows = this.getValidationRows();
+      const rowIndex = this.getValidationRowIndex(row, rows, 0);
+      const columnEntries = [];
+      this.loodHandleColumns(tableColumns, (column) => {
+        this.collectColumnValidateEntries(column, isEditTable, columnEntries);
+      });
+
+      // 只保留真正注册进 el-form 的 prop：validateField 传入全部未注册的 prop 会打警告
+      const registered = new Set(
+        (renderForm.fields || []).map((item) => item.prop)
+      );
+      const props = [];
+      columnEntries.forEach(({ column, templateWidget }) => {
+        const fieldWidget = this.resolveRowFieldWidget(row, templateWidget);
+        if (shouldSkipCellValidation(fieldWidget)) {
+          return;
+        }
+        const property = getCellFieldKey(fieldWidget, column);
+        const propName = buildTableCellFormProp(
+          tableFieldKeyName,
+          rowIndex,
+          property
+        );
+        if (propName && registered.has(propName) && !props.includes(propName)) {
+          props.push(propName);
+        }
+      });
+      return props;
+    },
+    /**
+     * 行内保存的校验入口：范围收敛到当前行（原生规则 + 必填兜底），
+     * 不校验其他行、也不校验表格外的表单字段。
+     * @param {Object} row 当前行。@returns {Boolean} 通过为 true。
+     */
+    validateEditRow(row) {
+      const formRef = this.getFormRef?.();
+      const renderForm = formRef?.$refs?.renderForm;
+      const props = this.collectRowValidateProps(row);
+      let nativeError = null;
+      if (renderForm && props.length) {
+        renderForm.validateField(props, (errorMsg) => {
+          if (!nativeError && errorMsg) {
+            nativeError = errorMsg;
+          }
+        });
+      }
+      if (nativeError) {
+        this.$message.error(nativeError);
+        return false;
+      }
+      const requiredError = this.validateEditRowRequired(row);
+      if (requiredError) {
+        this.$message.error(requiredError);
+        return false;
+      }
+      return true;
+    },
     /** @param {Boolean} required 是否将整个数据表设为必填。 */
     setRequired(required) {
       this.$set(this.widget.options, "required", !!required);
@@ -4428,14 +4519,9 @@ modules = {
       let logicalRowKey = obj.row?._X_ROW_KEY || null;
       let originalPhysicalId = null;
       try {
-        let valid = await new Promise((resolve, reject) => {
-          try {
-            formRef.validate(resolve);
-          } catch (error) {
-            reject(error);
-          }
-        });
-        if (!valid) return false;
+        // 行内保存只提交当前行，校验范围同步收敛到当前行：其他行与表外字段
+        // 的必填不该拦住单行保存（整体保存仍走 formRef.validate 的全量校验）
+        if (!this.validateEditRow(obj.row)) return false;
 
         let requestRow = obj.row;
         if (treeContext) {

package/src/components/xform/utils/tableColumnHelper.js

@@ -1,3 +1,47 @@
+import { columnFormatMap } from "./util";
+
+/**
+ * 列的某一侧（展示 / 编辑）是否真的配了组件。
+ *
+ * 判据与表单加载时的实例化口径一致（见 form-render/indexMixin 的 columnLoopDo）：
+ * 只有 formatS / editFormatS 能映射出组件类型时该侧才会建 widget。纯格式化列
+ * （formatS 是 d1 这类格式码）与被改回空的列都不算。
+ * @param {Object} columnConfig 列配置。@param {Boolean} isEdit 是否编辑侧。
+ * @returns {Boolean}
+ */
+function hasColumnWidgetSide(columnConfig, isEdit) {
+  if (isEdit) {
+    return !!(
+      columnConfig.editWidget || columnFormatMap[columnConfig.editFormatS]
+    );
+  }
+  return !!(columnConfig.widget || columnFormatMap[columnConfig.formatS]);
+}
+
+/**
+ * 取该侧生效的列级组件配置。
+ *
+ * 动态列走 widgetOptions / editWidgetOptions（本来就没有 formatS），直接生效；
+ * 设计器静态列的 columnOption / editColumnOption 必须门控：展示组件被改回空
+ * 之后那份 columnOption 仍会留在模板 JSON 里，无条件读会让这列凭空变必填
+ * （表头星号 + 拦保存），而加载时的 applyColumnMetaToFieldWidget 只读对应侧，
+ * 两边口径不一致正是该现象的根因。
+ * @param {Object} columnConfig 列配置。@param {Boolean} isEdit 是否编辑侧。
+ * @returns {Object|null}
+ */
+function getEffectiveColumnOptions(columnConfig, isEdit) {
+  const dynamicOptions = isEdit
+    ? columnConfig.editWidgetOptions
+    : columnConfig.widgetOptions;
+  if (dynamicOptions) {
+    return dynamicOptions;
+  }
+  if (!hasColumnWidgetSide(columnConfig, isEdit)) {
+    return null;
+  }
+  return isEdit ? columnConfig.editColumnOption : columnConfig.columnOption;
+}
+
 function buildColumnConfigMap(tableColumns, map = {}) {
   if (!tableColumns || !tableColumns.length) {
     return map;
@@ -56,10 +100,8 @@ export function resolveColumnRequiredFlag(columnConfig) {
   if (columnConfig.widget?.options?.required) {
     return true;
   }
-  const widgetOptions =
-    columnConfig.widgetOptions ?? columnConfig.columnOption;
-  const editWidgetOptions =
-    columnConfig.editWidgetOptions ?? columnConfig.editColumnOption;
+  const widgetOptions = getEffectiveColumnOptions(columnConfig, false);
+  const editWidgetOptions = getEffectiveColumnOptions(columnConfig, true);
   return !!(widgetOptions?.required || editWidgetOptions?.required);
 }
 

package/src/utils/assetUrl.js

@@ -0,0 +1,19 @@
+/**
+ * 取出 require(图片) 的真实 URL。
+ *
+ * webpack4(url-loader，vue-cli 设了 esModule:false) 下 require 直接返回 URL 字符串；
+ * webpack5(vue-cli5 的 asset modules) 下返回的是 ES Module 命名空间对象，且该对象
+ * 由 Object.create(null) 生成——没有原型链就没有 toString，直接绑到 :src 上时
+ * setAttribute 会抛 "Cannot convert object to primitive value" 整棵子树渲染失败
+ * （webpack5 的 asset modules 没有 esModule 开关，只能在取值处兜底）。
+ *
+ * 消费应用的构建配置不受本库控制，凡是把 require 结果往 DOM 属性上放的地方都要过这里。
+ */
+export function assetUrl(mod) {
+  if (mod && typeof mod === "object") {
+    return mod.default || "";
+  }
+  return mod || "";
+}
+
+export default assetUrl;

package/src/utils/importLimit.js

@@ -0,0 +1,72 @@
+/**
+ * 导入文件闸门。
+ *
+ * 导入侧是整文件 readAsBinaryString 读进内存 → XLSX.read（占用通常是文件体积的
+ * 5~20 倍）→ 再逐格建行数组，全程同步且没有任何让步。此前没有大小与行数校验，
+ * 几十 MB 的 xlsx 会直接把标签页撑爆，且崩在 FileReader / XLSX 内部，用户看到的
+ * 同样是"页面崩溃"而不是一句提示。
+ *
+ * 阈值都可以由导入配置覆盖（maxFileSize / maxRowNum，也支持写在 importOption 上），
+ * 传 0 表示不限制。
+ */
+
+/** 导入文件大小上限（字节）。 */
+export const DEFAULT_IMPORT_FILE_SIZE = 20 * 1024 * 1024;
+
+/** 导入数据行数上限（不含模板前 3 行表头）。 */
+export const DEFAULT_IMPORT_ROW_NUM = 20000;
+
+const readOption = (option, key) => {
+  if (option && option[key] !== undefined) return option[key];
+  if (option && option.importOption && option.importOption[key] !== undefined) {
+    return option.importOption[key];
+  }
+  return undefined;
+};
+
+const resolveLimit = (value, defaultValue) => {
+  let num = Number(value);
+  if (!isFinite(num) || num < 0) return defaultValue;
+  return num;
+};
+
+/** @param {Object} option 导入配置。@returns {Number} 文件大小上限，0 表示不限制。 */
+export function getImportFileSizeLimit(option) {
+  return resolveLimit(readOption(option, "maxFileSize"), DEFAULT_IMPORT_FILE_SIZE);
+}
+
+/** @param {Object} option 导入配置。@returns {Number} 行数上限，0 表示不限制。 */
+export function getImportRowLimit(option) {
+  return resolveLimit(readOption(option, "maxRowNum"), DEFAULT_IMPORT_ROW_NUM);
+}
+
+/** @param {File} file 待导入文件。@param {Object} option 导入配置。@returns {Boolean} */
+export function isImportFileOversize(file, option) {
+  let limit = getImportFileSizeLimit(option);
+  return limit > 0 && !!file && file.size > limit;
+}
+
+/** @param {Number} rowNum 数据行数。@param {Object} option 导入配置。@returns {Boolean} */
+export function isImportRowsOverLimit(rowNum, option) {
+  let limit = getImportRowLimit(option);
+  return limit > 0 && rowNum > limit;
+}
+
+/** @param {Number} bytes 字节数。@returns {Number} 保留一位小数的 MB 数。 */
+export function toFileSizeMb(bytes) {
+  return Math.round(((bytes || 0) / 1024 / 1024) * 10) / 10;
+}
+
+/**
+ * 取单元格文本：w（格式化文本）缺失时回退 v（原始值）。
+ * 模板里手工粘贴或公式生成的数值格常常只有 v，直接 w.trim() 会 TypeError，
+ * 而调用点外层的 catch 会把它吞成"点了导入没反应"。
+ * @param {Object} cell xlsx 单元格。
+ * @returns {String|undefined}
+ */
+export function getImportCellText(cell) {
+  if (cell === undefined || cell === null) return undefined;
+  let text = cell.w !== undefined && cell.w !== null ? cell.w : cell.v;
+  if (text === undefined || text === null) return undefined;
+  return String(text).trim();
+}

package/src/utils/vab.js

@@ -13,6 +13,7 @@ import XEUtils from "xe-utils";
 import prefixConfig from "@/prefixConfig.js";
 import moment from "moment";
 import { openView } from "./repeatOpen";
+import { assetUrl } from "./assetUrl";
 
 let imFun = {
   request,
@@ -28,7 +29,8 @@ let imFun = {
 };
 
 function reqImg(a) {
-  return require("@/resources/images/" + a);
+  /* webpack5 下 require 返回的是无原型的 Module 对象，直接当 src 用会崩，统一取真实 URL */
+  return assetUrl(require("@/resources/images/" + a));
 }
 
 const FILE_ICON_NAME_MAP = {
@@ -398,6 +400,8 @@ install = (Vue, opts = {}) => {
   Vue.prototype.$baseLodash = imFun.lodash;
   /* 全局事件总线 */
   Vue.prototype.$baseEventBus = new Vue();
+  /* 模板里 :src="$assetUrl(require(...))" 用，见 utils/assetUrl.js */
+  Vue.prototype.$assetUrl = assetUrl;
 
   Vue.prototype.$commonFileUtil = {
     // 文件类型获取与判断接口