Git 代码推送技能

初始化本地 Git 仓库，提交所有代码变更，配置远程仓库地址并推送到远程。支持多种代码托管平台的认证方式。

功能说明

本技能用于快速将本地项目代码提交并推送到远程 Git 仓库，覆盖从初始化仓库到首次推送的全流程。

核心能力

• Git 仓库初始化与基础配置
• .gitignore 最佳实践（自动生成）
• 多平台 Token 认证支持
• 首次推送到新仓库
• 常见问题排查与解决

适用场景

• 新项目首次推送到远程仓库
• 本地代码需要提交并推送
• 需要配置 Git 远程仓库
• 多平台代码托管（GitHub/GitLab/Codeup/Gitee）

必要信息

推送前请准备以下信息：

| 信息 | 必填 | 说明 | 示例 | |------|------|------|------| | 仓库地址 | 是 | 远程仓库 HTTPS 地址 | https://codeup.aliyun.com/xxx/project.git | | 认证 Token | 是 | 平台访问令牌 | Token 字符串 | | 分支名 | 否 | 推送分支，默认 main | main / master | | 提交信息 | 否 | 提交说明 | "初始提交" / "feat: 新增功能" |

操作流程

第一步：检查 Git 环境

git --version

第二步：初始化仓库

如果项目还没有初始化 Git：

git init
git config user.name "Your Name"
git config user.email "you@example.com"

第三步：配置 .gitignore

确保 .gitignore 文件包含以下常用排除项：

# 依赖目录
.venv/
node_modules/
__pycache__/
vendor/

# 环境变量
.env
.env.local
.env.*

# 数据目录
data/
redis_data/
logs/

# IDE 配置
.vscode/
.idea/

# 系统文件
.DS_Store
Thumbs.db

# 编译产物
dist/
build/
*.exe
*.dll
*.so

如果项目没有 .gitignore，自动创建一个合适的。

第四步：添加远程仓库

git remote add origin <仓库地址>
# 如果已存在则更新
git remote set-url origin <仓库地址>

第五步：提交代码

git add .
git commit -m "提交信息"
git branch -M main

第六步：推送到远程

根据平台选择对应的认证方式：

GitHub / GitLab

git push https://oauth2:<your-token>@github.com/user/repo.git main

阿里云效 Codeup

git -c "http.extraHeader=PRIVATE-TOKEN: <your-token>" push origin main

Gitee

git push https://<username>:<your-token>@gitee.com/user/repo.git main

多平台认证速查表

| 平台 | 认证方式 | 示例 | |------|---------|------| | GitHub | URL 内联 oauth2 | https://oauth2:TOKEN@github.com/user/repo.git | | GitLab | URL 内联 oauth2 | https://oauth2:TOKEN@gitlab.com/user/repo.git | | 阿里云效 Codeup | HTTP Header | git -c "http.extraHeader=PRIVATE-TOKEN: TOKEN" push | | Gitee | URL 内联用户名+Token | https://USERNAME:TOKEN@gitee.com/user/repo.git | | 腾讯工蜂 | URL 内联 oauth2 | https://oauth2:TOKEN@git.code.tencent.com/user/repo.git |

提示：不确定平台时，先尝试 oauth2:TOKEN@ 方式，不行再试 HTTP Header 方式。

常见问题

推送被拒绝（非 fast-forward）

git pull --rebase origin main
git push origin main

大文件无法推送

• 使用 .gitignore 排除大文件
• 大文件使用 Git LFS 管理
• 检查是否有误提交的二进制文件

记住凭证

# Windows 凭证管理器
git config --global credential.helper manager

# 永久记住（仅测试环境使用）
git config --global credential.helper store

首次推送新仓库

确保远程仓库是空的（不要勾选"使用 README 初始化仓库"），然后：

git init
git add .
git commit -m "初始提交"
git branch -M main
git remote add origin <仓库地址>
git push -u origin main

注意事项

1. Token 安全：不要在日志或公开场合泄露访问令牌
2. 敏感信息：密码、密钥、Token 绝对不能提交到 Git
3. 大文件：超过 100MB 的文件不要直接提交到 Git
4. .gitignore：提交前检查是否有敏感文件被意外提交
5. 提交规范：建议遵循 Conventional Commits 规范
6. 分支命名：注意区分 main 和 master 默认分支

许可证

MIT License