Git-Stats数据导入完全指南：从GitHub和BitBucket迁移历史提交

想要在本地拥有完整的Git提交统计日历吗？git-stats 这个强大的本地Git统计工具能帮你实现GitHub风格的贡献日历！本文将为你详细介绍如何快速导入GitHub和BitBucket上的历史提交数据，让你的本地贡献日历不再从零开始。🚀

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

为什么需要数据导入？

当你第一次使用git-stats时，可能会发现你的贡献日历几乎是空白的。这是因为git-stats默认只记录安装后的提交历史。为了获得完整的贡献视图，你需要导入之前在其他平台上的所有提交记录。

快速导入单个仓库数据

使用git-stats-importer工具可以轻松导入单个仓库的提交历史：

# 安装导入工具
npm install -g git-stats-importer

# 进入要导入的仓库目录
cd path/to/your-repository

# 开始导入提交记录
git-stats-importer

这个工具会扫描当前Git仓库的所有提交，并将它们添加到你的git-stats数据库中。整个过程简单快捷，无需复杂配置！✨

批量导入GitHub和BitBucket数据

想要一次性导入所有GitHub和BitBucket仓库的提交记录？没问题！使用repository-downloader工具可以实现这个目标：

# 克隆仓库下载器
git clone https://gitcode.com/gh_mirrors/gi/git-stats

# 进入下载器目录
cd repository-downloader

# 安装依赖
npm install

# 开始下载和导入
./start

这个工具会自动下载你在GitHub和BitBucket上的所有仓库，并逐个导入它们的提交历史。

数据迁移注意事项

如果你是从git-stats 1.x版本升级到2.x版本，需要注意数据格式的变化。新的数据格式更加简洁高效：

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

配置个性化显示

通过创建 ~/.git-stats-config.js 配置文件，你可以自定义git-stats的显示效果：

module.exports = {
    theme: "DARK",      // 支持DARK或LIGHT主题
    path: "~/.git-stats",
    authors: false,     // 是否显示作者饼图
    global_activity: false // 是否显示全局活动日历

导出可视化结果

导入数据后，你可以将统计结果导出为HTML文件或图片：

# 导出为HTML
git-stats --raw | git-stats-html -o stats.html

# 生成图片格式
pageres stats.html 775x250

常见问题解决方案

如果在导入过程中遇到问题，可以尝试以下方法：

• 检查网络连接是否正常
• 确认GitHub/BitBucket API令牌权限
• 重新运行迁移脚本：scripts/migration/2.0.0.js

通过以上步骤，你就能在本地拥有一个完整的、包含所有历史提交的Git贡献日历了！🎉

记得定期使用git-stats来查看你的编码活动趋势，这不仅能帮助你了解自己的工作模式，还能成为激励自己持续编码的强大动力！

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