1. 本地Git环境准备与Gitee仓库创建1.1 Git安装与基础配置对于Windows用户建议直接下载Git for Windows安装包当前最新版为2.45.1。安装过程中有几个关键选项需要注意选择Vim作为默认编辑器适合有Linux经验的用户或改用其他编辑器勾选Git from the command line and also from 3rd-party software选项换行符处理选择Checkout as-is, commit as-is避免跨平台问题安装完成后需要执行的基础配置git config --global user.name 你的姓名 git config --global user.email 你的邮箱 git config --global core.autocrlf false # 禁止自动转换换行符 git config --global core.ignorecase false # 区分文件名大小写注意邮箱建议使用Gitee账号绑定的邮箱这样提交记录才能正确关联到你的账号1.2 Gitee仓库创建要点在Gitee创建仓库时有几个关键选项会影响后续操作仓库类型选择公开仓库适合开源项目私有仓库适合企业或个人私有项目初始化选项初始化README.md推荐勾选选择.gitignore模板根据项目类型选择选择开源许可证GPL-3.0/MIT/Apache等高级设置设置默认分支名称main/master启用/禁用Wiki功能设置仓库可见范围创建完成后建议立即在仓库设置中添加SSH公钥后续操作会更方便。在本地生成SSH密钥对ssh-keygen -t ed25519 -C your_emailexample.com2. 本地项目与远程仓库关联2.1 已有项目初始化对于已有本地代码目录执行以下操作将其初始化为Git仓库cd /path/to/your/project git init git add . # 添加所有文件到暂存区 git commit -m 初始提交 # 创建首次提交2.2 远程仓库关联方法关联远程仓库有三种主流方式各有适用场景HTTPS方式适合新手git remote add origin https://gitee.com/yourname/repo.gitSSH方式推荐长期使用git remote add origin gitgitee.com:yourname/repo.git本地已有仓库推送到新仓库git remote rename origin old-origin # 如果已有origin git remote add origin gitgitee.com:yourname/repo.git git push -u origin --all # 推送所有分支 git push -u origin --tags # 推送所有标签实操技巧使用git remote -v命令可以查看当前配置的远程仓库地址3. 代码提交与推送全流程3.1 日常开发提交规范推荐使用以下工作流程查看当前修改状态git status添加变更到暂存区git add . # 添加所有变更 git add -u # 只添加已跟踪文件的变更 git add -p # 交互式选择变更片段创建有意义的提交信息git commit -m fix: 修复用户登录验证问题 - 修正密码加密逻辑 - 添加登录失败次数限制 - 优化错误提示信息提交信息规范建议类型前缀feat/fix/docs/style/refactor/test等标题不超过50字符正文详细说明修改内容和原因相关issue用#号引用3.2 推送代码到Gitee首次推送需要设置上游分支git push -u origin main # 根据你的分支名称调整后续推送简化命令git push遇到冲突时的处理流程先拉取远程变更git pull --rebase解决冲突后继续rebasegit add . git rebase --continue最后推送git push4. 高级操作与问题排查4.1 分支管理策略推荐的分支工作流main/master ┬─ release/v1.0 ├─ develop ┬─ feature/login ├─ feature/payment └─ hotfix/issue-123常用分支操作# 创建新分支 git checkout -b feature/new-module # 切换分支 git checkout develop # 合并分支 git merge --no-ff feature/new-module # 删除本地分支 git branch -d feature/old # 删除远程分支 git push origin --delete feature/old4.2 常见问题解决方案误提交大文件后无法推送# 查找大文件 git rev-list --objects --all | grep $(git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -5 | awk {print$1}) # 从历史中彻底删除 git filter-branch --tree-filter rm -f path/to/large/file HEAD提交信息写错需要修改git commit --amend # 修改最近一次提交 git rebase -i HEAD~3 # 修改多个历史提交误删文件需要恢复git checkout HEAD -- path/to/file # 恢复单个文件 git reset --hard HEAD # 恢复所有修改需要忽略已提交的文件git rm --cached config/database.yml echo config/database.yml .gitignore git add .gitignore git commit -m 忽略本地配置文件5. 自动化与效率提升5.1 Git Hook应用在.git/hooks目录下添加脚本可实现自动化操作。例如pre-commit钩子检查代码风格#!/bin/sh # 检查是否有调试代码 if git diff --cached | grep -E console\.log|debugger; then echo 发现调试代码请移除后再提交。 exit 1 fi # 运行ESLint检查 npx eslint . if [ $? -ne 0 ]; then echo ESLint检查未通过 exit 1 fi5.2 别名配置在~/.gitconfig中添加以下别名可以提升效率[alias] co checkout br branch ci commit st status last log -1 HEAD unstage reset HEAD -- lg log --color --graph --prettyformat:%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)%an%Creset --abbrev-commit5.3 IDE集成技巧主流IDE的Git集成优化建议VS Code安装GitLens扩展配置自动获取和推送使用内置的冲突解决工具IntelliJ系列启用Commit工具窗口配置Before Commit检查项使用Annotate功能查看代码修改历史Eclipse安装EGit插件配置Git Staging视图使用Interactive Rebase功能6. 团队协作最佳实践6.1 代码审查流程推荐使用Gitee的Pull Request功能创建特性分支开发完成后发起PR团队成员评审代码通过CI检查合并到主分支PR模板示例## 变更内容 - [ ] 功能1 - [ ] 功能2 ## 测试验证 1. 测试步骤1 2. 测试步骤2 ## 相关Issue Close #123 ## 截图/录屏 6.2 分支保护策略在Gitee仓库设置中建议启用主分支保护禁止直接推送要求PR合并要求代码审查要求CI通过提交规范检查提交信息格式签名验证关联Issue自动化检查代码风格检查单元测试覆盖率构建验证6.3 大文件存储方案对于二进制大文件建议使用Git LFS安装Git LFSgit lfs install跟踪大文件类型git lfs track *.psd git lfs track *.zip提交并推送git add .gitattributes git commit -m 添加LFS跟踪 git pushGitee对LFS的支持情况免费账户1GB存储单文件最大200MB需要仓库开启LFS功能