JQGrid同名列顺序调换后搜索功能异常原因咨询

出现这种现象的核心原因是jqGrid的colModel要求列的name属性必须唯一，重复的name会导致内部逻辑处理冲突，尤其是filterToolbar搜索功能的列匹配逻辑：

• jqGrid在初始化filterToolbar时，会遍历colModel中的列，以name作为唯一标识绑定搜索规则。当存在多个同名列时，只会识别第一个出现的列，后续同名列的配置会被忽略。

两种场景的具体差异： #

1. 可见Budget列在上，隐藏列在下
   filterToolbar会绑定到第一个name: 'Budget'的可见列，该列配置了ignoreCase: true，搜索逻辑基于文本匹配规则，原始数据中的Budget字段能和搜索输入正常匹配，因此搜索功能正常。

2. 隐藏Budget列在上，可见列在下
   filterToolbar会绑定到第一个name: 'Budget'的隐藏列，该列配置了sorttype: 'number'，搜索逻辑会按数值类型进行匹配。但该列hidden: true的属性会导致搜索规则无法正确关联到表格的可见行数据，同时用户操作的可见列输入框与绑定的隐藏列规则不匹配，最终表现为搜索功能失效。

额外说明： #

这种重复设置name的用法不符合jqGrid的设计规范，不仅会导致搜索问题，还可能引发排序、合计计算等其他功能异常。正确的做法是为两个列设置不同的name，例如将用于合计的隐藏列命名为BudgetTotal，再调整footerData的对应配置即可避免冲突。

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