上传git仓库
一、前置准备
安装 Git
- 下载地址：Git 官方下载，安装后配置用户信息（全局生效）：
bash
运行
git config --global user.name "你的用户名" git config --global user.email "你的邮箱（需与Git仓库平台绑定）" - 验证配置：
git config --list查看是否显示上述信息。
- 下载地址：Git 官方下载，安装后配置用户信息（全局生效）：
创建远程仓库在 GitHub/GitLab/Gitee 等平台新建仓库，注意：
- 可选是否勾选「Initialize this repository with a README」（首次上传建议不勾选，避免冲突）；
- 记录仓库的远程地址（HTTPS 或 SSH）：
- HTTPS 示例：
https://github.com/你的用户名/仓库名.git - SSH 示例：
git@github.com:你的用户名/仓库名.git（推荐，免每次输密码，需配置 SSH 密钥）。
- HTTPS 示例：
二、场景 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/ *.swp2. 分支管理（进阶）
- 创建新分支：
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 密钥」中粘贴公钥，保存即可。
五、常见问题解决
推送失败：remote: Repository not found→ 检查远程仓库地址是否正确：
git remote -v，若错误则修改：git remote set-url origin 正确地址。pull 冲突：Automatic merge failed→ 手动解决冲突文件（文件中会标记
<<<<<<< HEAD/=======/>>>>>>> 分支名），解决后：bash
运行
git add 冲突文件 git commit -m "解决合并冲突" git push提交后发现漏传文件→ 补充添加后重新提交（避免多一条无用记录）：
bash
运行
git add 漏传文件 git commit --amend # 追加到上一次提交，会进入编辑器，保存即可 git push --force # 强制推送（谨慎！多人协作时避免使用）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，避免冲突。