Git 代码提交管理指南

发布于:2025-09-03 ⋅ 阅读:(11) ⋅ 点赞:(0)

目录

1. 初始设置(首次使用 Git 时)

2. 日常提交工作流程

场景一:已有本地项目,首次连接到远程仓库

场景二:已有远程仓库,克隆到本地

3. 更精细的文件管理

4. 提交信息规范

5. 分支管理策略

6. 高级技巧

7. 团队协作注意事项

8. .gitignore 文件


提交代码到 Git 仓库是版本控制的核心操作。以下是完整的 Git 代码管理流程:

1. 初始设置(首次使用 Git 时)

# 配置用户信息(全局设置,一次即可)
git config --global user.name "你的姓名"
git config --global user.email "你的邮箱"

# 检查配置
git config --list

2. 日常提交工作流程

场景一:已有本地项目,首次连接到远程仓库

# 进入项目目录
cd your-project

# 初始化本地仓库
git init

# 添加远程仓库地址
git remote add origin https://github.com/用户名/仓库名.git

# 添加所有文件到暂存区
git add .

# 提交更改
git commit -m "初始提交:项目基础结构"

# 推送到远程仓库(首次推送需要 -u 参数)
git push -u origin main  # 或 master,取决于你的默认分支名

场景二:已有远程仓库,克隆到本地

# 克隆远程仓库
git clone https://github.com/用户名/仓库名.git

# 进入项目目录
cd 仓库名

# 进行代码修改...

# 添加修改的文件到暂存区
git add 文件名  # 或 git add . 添加所有修改

# 提交更改
git commit -m "描述你的修改内容"

# 推送到远程仓库
git push origin main

3. 更精细的文件管理

# 查看当前状态(哪些文件被修改/添加/删除)
git status

# 查看具体更改内容
git diff

# 添加特定文件
git add index.html style.css script.js

# 添加所有修改的文件(不包括新文件)
git add -u

# 添加所有文件(包括新文件和修改的文件)
git add -A
# 或
git add .

# 提交时跳过暂存区,直接提交所有已跟踪文件的修改
git commit -a -m "提交所有修改"

# 撤销暂存区的文件(取消 add)
git reset 文件名

# 撤销对文件的修改(危险操作,会丢失更改)
git checkout -- 文件名

4. 提交信息规范

提交信息应该清晰明了,遵循约定式提交(Conventional Commits)更好:

类型(范围): 简短描述
详细描述(可选)
突破性变更说明(可选)
关联问题编号(可选)

常见类型:

  • feat: 新功能

  • fix: 修复bug

  • docs: 文档更新

  • style: 代码格式调整

  • refactor: 代码重构

  • test: 测试相关

  • chore: 构建过程或辅助工具变动

示例:

git commit -m "feat(用户认证): 添加第三方登录功能

- 实现Google OAuth登录
- 添加Facebook登录支持
- 更新登录页面UI

 closes #123"

5. 分支管理策略

# 创建新分支
git branch 新分支名

# 切换分支
git checkout 分支名

# 创建并切换分支
git checkout -b 新分支名

# 查看所有分支
git branch -a

# 合并分支
git checkout main
git merge 功能分支名

# 删除分支
git branch -d 分支名  # 安全删除(已合并)
git branch -D 分支名  # 强制删除(未合并)

6. 高级技巧

# 修改最后一次提交(追加修改或修改提交信息)
git commit --amend

# 暂存当前工作,临时切换分支
git stash        # 暂存修改
git stash pop    # 恢复暂存的修改

# 查看提交历史
git log
git log --oneline --graph --all  # 图形化查看

# 撤销提交(保留更改)
git reset --soft HEAD~1

# 完全撤销提交(丢弃更改)
git reset --hard HEAD~1

7. 团队协作注意事项

  1. 频繁拉取更新:开始工作前先 git pull

  2. 小步提交:每次提交只解决一个问题

  3. 明确提交信息:让他人理解你的修改意图

  4. 使用特性分支:不要在 main/master 分支直接开发

  5. 定期推送:避免本地积压太多未推送的提交

8. .gitignore 文件

创建 .gitignore 文件来排除不需要版本控制的文件:

# 依赖目录
node_modules/
vendor/

# 环境配置
.env
.env.local

# 日志文件
*.log

# 系统文件
.DS_Store
Thumbs.db

# 构建输出
dist/
build/

通过遵循这些实践,可以有效地使用 Git 管理代码,保持项目历史清晰可追溯。


网站公告

今日签到

点亮在社区的每一天
去签到