1. 为什么vxe-table v2.8+需要keep-source参数
最近在项目中升级vxe-table到v2.8+版本后，发现表格的编辑状态显示和数据还原功能突然失效了。控制台还不断弹出警告："缺少必要的keep-source参数"。经过一番排查，终于搞明白这是v2.8版本引入的重要变更。
vxe-table在v2.8版本对数据状态管理机制进行了重构优化。简单来说，之前的版本会自动维护数据状态，但这种做法在复杂场景下存在性能问题。新版本改为按需管理，开发者需要显式声明是否需要保留原始数据副本。这就是keep-source参数的作用 - 它决定是否保留表格数据的原始状态。
我刚开始也很困惑，为什么一个看似简单的参数会导致这么多功能异常。后来发现，像编辑状态显示（单元格修改后的红色标记）、数据还原（恢复到修改前的状态）这些功能，都依赖于原始数据的对比。如果没有保留原始数据副本，这些功能自然就无法正常工作。
2. keep-source参数的两种配置方式
2.1 局部配置：单个表格实例
最直接的配置方式是在具体的vxe-table组件上添加keep-source属性。这种方式适合只需要在特定表格保留数据状态的场景：
<vxe-table border keep-source :edit-config="{trigger: 'click', mode: 'cell', showStatus: true}" :data="tableData"> <vxe-column type="checkbox" width="60"></vxe-column> <vxe-column field="name" title="Name"></vxe-column> <vxe-column field="sex" title="Sex" :edit-render="{name: 'input'}"></vxe-column> </vxe-table>实测发现，这个属性不仅影响编辑状态，还会影响以下功能：
- 数据修改状态显示（showStatus）
- getRecordChanges获取变更数据
- revertData数据还原
- 部分校验功能
2.2 全局配置：所有表格实例
如果项目中有多个表格都需要保留数据状态，可以在初始化时全局配置：
import VXETable from 'vxe-table' VXETable.setup({ keepSource: true })需要注意的是，全局配置使用的是keepSource（驼峰命名），而组件属性是keep-source（短横线命名）。这个细节很容易被忽略，我就曾经因为写错命名方式调试了半天。
3. 常见问题与解决方案
3.1 控制台警告但功能正常
有时候即使看到控制台警告，表格功能似乎也能正常工作。这种情况其实很危险，因为：
- 简单操作可能没问题，但复杂交互会出问题
- 不同浏览器表现可能不一致
- 未来版本可能会完全禁用相关功能
建议无论是否看到问题，只要使用到数据状态相关功能，都应该显式配置keep-source。
3.2 性能优化建议
保留数据副本确实会增加内存占用，特别是处理大数据量时。我的优化经验是：
- 只有需要编辑、状态显示的表格才配置keep-source
- 对于纯展示的表格，可以不配置
- 大数据量表格考虑手动清理不再需要的历史状态
4. 深入理解keep-source的工作原理
为了更好地使用这个参数，我花时间研究了它的实现原理。简单来说，启用keep-source后：
- 初始化时会深拷贝一份原始数据
- 每次修改都会对比原始数据
- 状态标记基于差异比较结果
- 还原操作实际上是恢复原始副本
这种机制带来了很大的灵活性，比如可以实现：
- 只保存部分字段的原始值
- 自定义比较算法
- 按需加载原始数据
虽然官方文档没有详细说明这些细节，但了解这些原理对解决复杂问题很有帮助。比如我曾经遇到一个需求，需要在服务端保存修改历史，就是通过自定义keep-source的实现来完成的。
