上传git仓库

一、前置准备

1. 安装 Git

   • 下载地址：Git 官方下载，安装后配置用户信息（全局生效）：

     bash

     运行

     git config --global user.name "你的用户名" git config --global user.email "你的邮箱（需与Git仓库平台绑定）"

   • 验证配置：git config --list查看是否显示上述信息。

2. 创建远程仓库在 GitHub/GitLab/Gitee 等平台新建仓库，注意：

   • 可选是否勾选「Initialize this repository with a README」（首次上传建议不勾选，避免冲突）；
   • 记录仓库的远程地址（HTTPS 或 SSH）：
     • HTTPS 示例：https://github.com/你的用户名/仓库名.git
     • SSH 示例：git@github.com:你的用户名/仓库名.git（推荐，免每次输密码，需配置 SSH 密钥）。

二、场景 1：首次上传本地代码到远程仓库

步骤 1：初始化本地 Git 仓库

打开终端 / 命令行，进入本地代码目录：

bash

运行

cd 你的代码目录路径 # 例如：cd /Users/xxx/project/my-app git init # 初始化本地仓库，生成 .git 隐藏文件夹

步骤 2：添加文件到暂存区

bash

运行

git add . # 添加当前目录所有文件到暂存区（推荐） # 或指定文件：git add 文件名1 文件名2 # 例如 git add index.html src/

• 查看暂存状态：git status（红色 = 未暂存，绿色 = 已暂存）。

步骤 3：提交暂存区文件到本地仓库

bash

运行

git commit -m "首次提交：初始化项目结构" # 提交说明必须写，清晰描述本次修改 # 若提交后发现备注写错：git commit --amend -m "修正后的备注"

步骤 4：关联远程仓库

bash

运行

git remote add origin 你的远程仓库地址 # origin 是远程仓库的默认别名，可自定义 # 验证关联：git remote -v # 显示 origin 的 fetch/push 地址

步骤 5：推送本地代码到远程仓库

bash

运行

# 首次推送需指定分支（默认主分支：main 或 master，取决于平台） git push -u origin main # -u 绑定本地main分支与远程main分支，后续可直接 git push # 若远程仓库默认分支是 master：git push -u origin master

• 若用 HTTPS 地址，会提示输入 Git 平台的用户名和密码（GitHub 需用「个人访问令牌」替代密码，GitLab/Gitee 同理）；
• 若用 SSH 地址，需先配置 SSH 密钥（见下方「进阶配置」）。

三、场景 2：日常更新代码（本地已有仓库，推送到远程）

步骤 1：拉取远程最新代码（避免冲突）

bash

运行

git pull origin main # 先同步远程最新代码到本地（多人协作必做）

步骤 2：添加修改的文件到暂存区

bash

运行

git add . # 或指定文件：git add 修改的文件名

步骤 3：提交到本地仓库

bash

运行

git commit -m "修复xxbug/新增xx功能/优化xx逻辑" # 备注清晰，便于追溯

步骤 4：推送到远程仓库

bash

运行

git push # 已绑定分支（-u），直接推送；未绑定则：git push origin main

四、关键细节与注意事项

1. 忽略不需要上传的文件（.gitignore）

创建.gitignore文件放在仓库根目录，写入需忽略的文件 / 目录，示例：

plaintext

# 依赖目录 node_modules/ venv/ # 编译产物 dist/ build/ # 配置文件（含敏感信息） .env config/local.json # 日志 *.log # 编辑器缓存 .idea/ .vscode/ *.swp

2. 分支管理（进阶）

• 创建新分支：git checkout -b feature/xxx（基于当前分支创建）
• 切换分支：git checkout main
• 推送新分支到远程：git push -u origin feature/xxx
• 合并分支（如 feature 合并到 main）：

  bash

  运行

  git checkout main git merge feature/xxx git push

3. SSH 密钥配置（免密码推送）

• 生成 SSH 密钥（一路回车）：

  bash

  运行

  ssh-keygen -t rsa -C "你的邮箱"

• 查看公钥（复制内容）：

  bash

  运行

  # Mac/Linux cat ~/.ssh/id_rsa.pub # Windows type C:\Users\你的用户名\.ssh\id_rsa.pub

• 在 Git 平台（GitHub/GitLab）的「设置 → SSH 密钥」中粘贴公钥，保存即可。

五、常见问题解决

1. 推送失败：remote: Repository not found→ 检查远程仓库地址是否正确：git remote -v，若错误则修改：git remote set-url origin 正确地址。

2. pull 冲突：Automatic merge failed→ 手动解决冲突文件（文件中会标记<<<<<<< HEAD/=======/>>>>>>> 分支名），解决后：

   bash

   运行

   git add 冲突文件 git commit -m "解决合并冲突" git push

3. 提交后发现漏传文件→ 补充添加后重新提交（避免多一条无用记录）：

   bash

   运行

   git add 漏传文件 git commit --amend # 追加到上一次提交，会进入编辑器，保存即可 git push --force # 强制推送（谨慎！多人协作时避免使用）

4. HTTPS 推送提示密码错误→ GitHub/GitLab 已不支持密码登录，需生成「个人访问令牌」：

   • GitHub：设置 → Developer settings → Personal access tokens → 生成（勾选 repo 权限），推送时密码填令牌。

六、总结

核心流程：git init（首次） →git add→git commit→git remote add（首次） →git push日常迭代：git pull→git add→git commit→git push关键原则：

• 每次提交备注清晰，便于追溯；
• 敏感文件（密码、密钥）绝不提交，用.gitignore忽略；
• 多人协作先pull再push，避免冲突。