微信扫一扫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
注意事项
- Token 安全：不要在日志或公开场合泄露访问令牌
- 敏感信息：密码、密钥、Token 绝对不能提交到 Git
- 大文件：超过 100MB 的文件不要直接提交到 Git
- .gitignore：提交前检查是否有敏感文件被意外提交
- 提交规范：建议遵循 Conventional Commits 规范
- 分支命名：注意区分
main和master默认分支
许可证
MIT License