终极指南：使用 Fake Git History 工具美化你的 GitHub 贡献图

终极指南：使用 Fake Git History 工具美化你的 GitHub 贡献图

【免费下载链接】fake-git-historyGenerate Git commits.项目地址: https://gitcode.com/gh_mirrors/fa/fake-git-history

想要让你的 GitHub 贡献图看起来更加丰富多彩吗？fake-git-history 是一个功能强大的命令行工具，专门用于生成逼真的 Git 提交历史，让你的 GitHub 或 GitLab 活动图表充满生机。无论是为了演示、教学还是个人展示，这个工具都能帮助你快速创建令人印象深刻的代码贡献记录。

🚀 快速开始：三分钟上手教程

环境准备检查清单

在使用 fake-git-history 之前，请确保你的系统已经安装了必要的运行环境：

• Git 版本控制工具：用于管理生成的提交记录
• Node.js 运行环境：确保工具能够正常执行

一键生成提交历史

最简单的使用方法就是直接运行以下命令：

npx fake-git-history

这个命令会在当前目录下创建一个名为my-history的新文件夹，并自动生成过去一年的 Git 提交记录。

创建并推送至私有仓库

生成提交后，你需要创建一个私有仓库来展示这些成果：

cd my-history git remote add origin https://gitcode.com/gh_mirrors/fa/fake-git-history git push -u origin main

完成这些步骤后，刷新你的 GitHub 个人主页，就能看到焕然一新的贡献图表了！

⚙️ 高级配置：定制专属提交模式

预览模式：先看后做

在正式生成提交之前，你可以使用预览功能查看效果：

npx fake-git-history --preview

提交频率控制

想让你的贡献图看起来更自然？通过调整频率参数来实现：

npx fake-git-history --frequency 50

这个设置会让工具在约50%的日期中生成提交，避免过于规律的模式。

智能时间分布模式

fake-git-history 提供三种时间分布模式，让你的提交记录更符合真实工作习惯：

标准工作模式：

npx fake-git-history --distribution workHours

这种模式会在工作日（特别是周二到周四）生成更多提交，模拟正常的办公时间。

业余时间模式：

npx fake-git-history --distribution afterWork

适合展示在晚上和周末进行编码的习惯。

自定义日期范围

默认情况下，工具会生成过去一年的提交记录。你也可以指定特定时间段：

npx fake-git-history --startDate "2024/01/01" --endDate "2024/12/31"

每日提交数量调整

控制每天生成的提交数量范围：

npx fake-git-history --commitsPerDay "2,8"

💡 实用场景与最佳实践

教学演示场景

在编程教学中，使用 fake-git-history 可以快速创建丰富的 Git 历史记录，帮助学生更好地理解版本控制的概念和工作流程。

项目测试环境

开发 Git 相关工具或插件时，这个工具能够提供大量的测试数据，确保你的工具在各种场景下都能稳定运行。

个人技能展示

虽然我们不建议在专业环境中滥用此工具，但在个人项目展示或学习记录中，适当的美化可以帮助你更好地展示学习进度。

🎯 使用注意事项

• 诚实原则：在专业环境中，请保持诚信，不要使用此工具误导他人
• 明确用途：如果使用了生成的提交记录，建议在项目说明中明确标注
• 适度使用：工具虽好，但真实的学习和项目经验才是最宝贵的财富

📋 完整命令参考表

通过本指南，你已经掌握了使用 fake-git-history 工具的所有核心技巧。记住，工具的目的是辅助学习和展示，真正的编程能力来自于持续的实践和项目积累。祝你使用愉快！

【免费下载链接】fake-git-historyGenerate Git commits.项目地址: https://gitcode.com/gh_mirrors/fa/fake-git-history