1. 初始上传（首次提交）注意事项

教程参考：Vscode上传代码库到 github

核心原则：小步快跑，频繁提交，信息清晰，先拉后推

1. 准备工作

## 创建 .gitignore 文件（重要！）
# 避免提交不必要的文件：node_modules, .env, 编译文件等

echo "node_modules/" >> .gitignore
echo ".env" >> .gitignore
echo ".DS_Store" >> .gitignore

2. 顺序不能错

## 正确顺序
git init
git add .  # 或 git add 具体文件
git commit -m "描述"
git branch -M main
git remote add origin URL
git push -u origin main

3. 常见问题

• 远程仓库不为空：如果远程仓库有 README.md

  git pull origin main --allow-unrelated-histories
  git push

• 认证问题：

• 使用 HTTPS：需要输入用户名和 token（不是密码）
• 使用 SSH：需提前配置 SSH 密钥

2. 后续上传的注意事项

1. 基本流程（小修改）

## 1. 检查当前状态
git status
## 2. 查看具体修改
git diff
## 3. 添加修改
git add 文件名
# 或 （全部代码）
git add . 
## 4. 提交
git commit -m "清晰的提交信息"
## 5. 推送
git push

2. 最佳实践要点（提交信息规范）

不好的示例

git commit -m "fix"
git commit -m "更新"

好的示例

git commit -m "fix: 修复用户登录时的空指针异常"
git commit -m "feat: 添加用户头像上传功能"
git commit -m "docs: 更新API使用说明"

提交频率

• 完成一个功能/修复一个问题就提交一次
• 不要积累大量修改一次性提交
• 每日工作结束前确保代码已提交

3. 多人协作时的注意事项

## 每次开始工作前先拉取最新代码
git pull origin main

## 推送前检查是否有冲突
git status

## 如果有冲突
git pull
## 解决冲突后
git add .
git commit -m "解决合并冲突"
git push

4. 不同场景的处理

场景1：只修改了部分文件

# 查看具体修改了哪些文件
git status

# 选择性添加
git add 文件1.js 文件2.js

# 查看将要提交的内容
git diff --cached

# 提交
git commit -m "描述"
git push

场景2：需要撤销修改

# 撤销工作区的修改（未add）
git checkout -- 文件名

# 撤销暂存区的修改（已add但未commit）
git reset HEAD 文件名
git checkout -- 文件名

# 撤销上一次提交
git reset --soft HEAD^  # 保留修改
git reset --hard HEAD^  # 丢弃修改（谨慎使用！）

5. 分支管理的建议

# 开发新功能时创建分支
git checkout -b feature/新功能名称

# 在分支上开发
git add .
git commit -m "feat: 新功能开发"
git push -u origin feature/新功能名称

# 完成后合并到main
git checkout main
git pull origin main
git merge feature/新功能名称
git push

6. 重要检查清单

每次提交前检查：

• 代码是否可以编译/运行

• 是否提交了敏感信息（密码、API密钥）

• 是否提交了不必要的文件

• 提交信息是否清晰

• 是否遵循团队规范

7. 常用命令速查

# 查看状态
git status

# 查看提交历史
git log --oneline

# 查看远程仓库
git remote -v

# 查看分支
git branch -a

# 查看文件修改内容
git diff

8. 错误处理

# 推送被拒绝（常见于多人协作）
git pull --rebase origin main
# 解决可能的冲突
git push

# 提交了错误的文件
# 方法1：新增提交来删除
git rm 文件名
git commit -m "删除错误文件"

# 方法2：修改上一次提交
git add 正确文件
git commit --amend
git push -f  # 强制推送（谨慎！会覆盖历史）

3. Git 工程重开后的处理

不需要重复的操作

1. ❌ git init（除非删除了整个项目重新下载）
2. ❌ git remote add（除非更换了远程仓库地址）
3. ❌ 重新设置用户名邮箱（除非在不同电脑上）

需要检查的操作

1. 验证配置是否存在

# 查看全局配置
git config --global --list
# 查看项目配置
git config --local --list

# 应该能看到：
# user.name=你的名字
# user.email=你的邮箱

2. 检查远程仓库

# 查看是否配置了远程仓库
git remote -v
# 应该显示 origin 指向的地址

核心原则：Git 配置是持久的，.git文件夹包含了项目的所有 Git 信息。只要这个文件夹存在，就不需要重新初始化。用户信息存储在电脑的 Git 配置中，除非换电脑或重装系统，否则也不需要重新设置。