Quick-git-advance NPM

✨ 特性一览

🎯 一键初始化 - 从本地到远程，一条命令搞定
🔄 双平台支持 - 无缝集成 GitHub 和 Gitee
🛡️ 智能检测 - 全方位冲突检查，避免误操作
🔑 自动配置 - SSH 密钥自动生成与配置
📝 交互友好 - 智能引导，清晰提示
🎨 高度可定制 - 灵活的配置选项
🔧 错误处理 - 完善的错误恢复机制
📦 项目模板 - 内置多种 .gitignore 模板

🚀 为什么选择 Quick Git Advance？

💡 痛点洞察：传统 Git 初始化流程的 7 大问题

重复劳动：每次都要重复git init、git remote add等命令
平台切换：GitHub/Gitee 配置差异导致操作不一致
网络延迟：国内访问 GitHub 经常超时
模板缺失：手动创建.gitignore 效率低下
配置分散：SSH 密钥、Token 等配置管理混乱
分支冲突：main/master 分支命名混乱
错误排查：认证失败等问题定位困难

传统步骤	存在问题
1. 访问 GitHub/Gitee 网站	⏰ 流程繁琐，耗时较长
2. 手动创建仓库	🔍 需要记忆多个命令
3. 配置 SSH 密钥	⚠️ 容易出错和遗漏
4. 本地初始化 Git	📝 重复性工作多
5. 编写 .gitignore	🔒 安全配置复杂
6. 设置远程仓库	🌐 多平台切换麻烦
7. 推送代码

Quick Git Advance 的优势

可通过一行命令一键完成 git 仓库全部初始化流程,自动配置 SSH 推送
可通过一行命令生成你想要的.gitignore 文件

核心优势	具体表现
效率提升	- 一键完成全部初始化流程 - 智能默认值，减少输入 - 配置持久化，一次设置永久生效 - 批量操作支持 - 一键生成.gitignore 文件
安全可靠	- 自动化 SSH 密钥管理 - 令牌安全存储 - 操作前自动检查 - 失败自动回滚
用户体验	- 清晰的命令行界面 - 智能的交互引导 - 详细的错误提示 - 完整的操作日志
功能完备	- 支持主流平台 - 完整的分支管理 - 灵活的配置选项 - 丰富的模板支持

📦 安装

# NPM
npm install -g quick-git-advance

🎯 快速开始

基础用法

# 进入项目目录
cd your-project

# 初始化仓库（交互式）
quick-git-advance init

核心讲解

核心为以下 4 个命令

quick-git-advance init 一键初始化并推送仓库
- -m
- --multi 创建多仓库
quick-git-advance config 配置文件
- --edit 修改
- --list 查看
quick-git-advance ignore 创建 ignore 文件
quick-git-advance reset 初始化配置

初始化流程交互

$ quick-git-advance init

当输入命令后会检测当前项目目录下是否含有.git文件夹,有的话会弹出提示,没有的话,将继续进行下一步操作

交互示例：

仓库名称: my-project
? 选择代码托管平台: (使用方向键选择)
❯ GitHub
  Gitee

? 仓库可见性: (使用方向键选择)
❯ 公开 (Public)
  私有 (Private)

? 仓库描述: My awesome project

? 主分支名称: [main]

? 是否需要创建独立的开发分支? (Y/n)

? 开发分支名称: [develop]

npm.io

如果有不同平台仓库想要同时使用这个项目可以带参 -m

npm.io

创建完整后推送代码会自动的创建远程仓库并进行推送以及本地和远程分支的管理

  git push //默认推送到github
  # 或
  git push gitee //推送到 gitee

配置管理交互

quick-git-advance config

交互示例：

当时有 windows 终端输入 quick-git-advance config --edit 时会默认打开记事本编辑配置而使用 git bash 打开会默认打开 vim 进行编辑

# 使用编辑器打开配置文件
quick-git-advance config --edit
# 或
quick-git-advance config -e

# 列出所有配置
quick-git-advance config --list
# 或
quick-git-advance config -l

npm.io