Git-Stats迁移指南：从旧版本升级到3.5.0的完整流程

Git-Stats迁移指南：从旧版本升级到3.5.0的完整流程

【免费下载链接】git-stats 🍀 Local git statistics including GitHub-like contributions calendars. 项目地址: https://gitcode.com/gh_mirrors/gi/git-stats

🚀 终极升级指南：轻松完成git-stats从旧版本到最新3.5.0的平滑迁移！如果你正在使用1.x.x或2.x.x版本的git-stats，这份完整的迁移教程将帮助你避免数据丢失，快速享受新版本功能。

💡 为什么需要迁移？

git-stats是一个强大的本地Git统计工具，能够生成类似GitHub贡献日历的可视化图表。从1.x.x到3.5.0版本，项目经历了重大的架构改进和数据格式优化，确保迁移过程顺利是保护你宝贵提交记录的关键。

🔄 主要版本变化概览

从1.x.x到2.x.x的重大变更

数据格式重构是最大的变化：

• 旧格式 (~/.git-stats)：

  {
    "2024-01-01": {
      "https://github.com/user/repo.git": {
        "abc123": "2024-01-01"
      }
    }
  }
  

• 新格式 (2.x.x+)：

  {
    "commits": {
      "2024-01-01": {
        "abc123": 1
      }
    }
  }
  

API使用方式变更

在1.x.x版本中：

var GitStats = require("git-stats");
GitStats.ansiCalendar(opts, fn);

在2.x.x及以上版本中：

var GitStats = require("git-stats");

// 自定义数据路径
var gs1 = new GitStats("path/to/some/data.json");

// 使用默认路径 (~/.git-stats)
var gs2 = new GitStats();

🛠️ 自动迁移流程

安装时自动迁移

当你安装3.5.0版本时，系统会自动执行迁移脚本：

npm install -g git-stats@3.5.0

迁移脚本位置：scripts/migration/2.0.0.js

手动迁移方法

如果自动迁移失败，你可以手动运行迁移脚本：

./scripts/migration/2.0.0.js

这个脚本会安全地转换你的~/.git-stats文件，保留所有历史提交记录。

📊 迁移后验证

完成迁移后，通过以下命令验证数据完整性：

git-stats --authors

如果一切正常，你将看到：

• ✅ 完整的贡献日历显示
• ✅ 作者统计信息
• ✅ 所有历史提交记录

🎯 新版本功能亮点

升级到3.5.0后，你将享受到：

• 🎨 增强的可视化效果 - 更清晰的日历显示
• ⚡ 性能优化 - 更快的统计生成速度
• 🔧 更好的配置管理 - 通过~/.git-stats-config.js自定义主题和行为

🚨 常见问题解决

迁移失败怎么办？

如果遇到迁移问题：

1. 备份你的~/.git-stats文件
2. 手动运行迁移脚本
3. 检查控制台输出是否有错误信息

数据丢失风险

迁移过程设计为无损迁移，但建议在升级前：

• 备份现有数据文件
• 记录当前的统计信息

💎 迁移成功提示

成功升级到git-stats 3.5.0后，你将拥有：

• 🗓️ 更美观的GitHub风格贡献日历
• 📈 更准确的提交统计
• 🔄 与最新工具链的兼容性

记住，定期更新git-stats可以确保你始终使用最稳定、功能最丰富的版本！🎉

【免费下载链接】git-stats 🍀 Local git statistics including GitHub-like contributions calendars. 项目地址: https://gitcode.com/gh_mirrors/gi/git-stats