Evidence版本升级指南：如何安全升级到最新版本

想要体验Evidence的最新功能和性能优化吗？掌握正确的版本升级方法至关重要。本指南将为你详细介绍如何安全、高效地将Evidence项目升级到最新版本，避免常见的升级陷阱和数据丢失问题。

📋 升级前的准备工作

在进行任何版本升级之前，充分的准备工作是确保升级成功的关键：

备份重要数据：确保所有关键数据文件已备份，特别是数据库文件如needful_things.duckdb，以及配置文件evidence.config.yaml

检查当前版本：通过CLI命令evidence --version确认当前安装的版本号

查看变更日志：仔细阅读CHANGELOG.md了解新版本的改动内容

🛠️ 升级方法详解

使用CLI命令一键升级

Evidence提供了专门的升级命令，这是最推荐的安全升级方式：

evidence upgrade

升级过程中可能需要检查凭证配置

手动更新依赖包

如果CLI命令不可用，也可以通过npm手动更新：

npm install @evidence-dev/evidence@latest @evidence-dev/core-components@latest

🔧 升级后的配置检查

升级完成后，务必进行以下配置检查：

验证配置文件：检查evidence.config.yaml中的设置是否与新版本兼容

检查数据源连接：确认所有数据源连接配置如connection.yaml是否正常工作

⚠️ 常见问题与解决方案

依赖冲突处理

如果遇到依赖包冲突，可以尝试：

npm install --force

组件兼容性问题

如果某些自定义组件出现兼容性问题，参考核心组件文档

数据迁移注意事项

对于重大版本更新，可能需要数据迁移，具体步骤详见官方文档

📊 验证升级成功

升级完成后，通过以下方式验证升级是否成功：

运行开发服务器：执行evidence dev确保应用正常启动

测试关键功能：验证图表组件、数据查询等核心功能是否正常运行

💡 最佳实践建议

• 在测试环境中先进行升级测试
• 阅读完整的升级说明文档中的实现逻辑
• 关注GitHub仓库的最新动态

通过遵循本指南，你可以顺利完成Evidence的版本升级，享受最新功能带来的便利和性能提升！🚀