1. 项目概述与核心价值每次看到同事或朋友还在用U盘或者微信传来传去地分享代码或者对着自己电脑里一堆版本混乱的项目文件夹头疼时我就特别想跟他们聊聊代码仓库托管这件事。今天要聊的就是把你的本地项目稳稳当当地上传到Gitee仓库的完整流程。Gitee也就是码云是国内一个非常主流的代码托管平台对于咱们国内的开发者来说访问速度快、社区活跃而且完全符合本地化的开发需求是GitHub一个非常优秀的替代或补充选择。这个操作听起来基础但里面门道不少。从最开始的Git环境准备到中间可能遇到的各类报错处理再到最后如何建立一个清晰、规范的提交历史每一步都藏着新手容易踩的坑。我见过太多人卡在“秘钥配置不对”、“远程仓库地址搞错”或者“提交信息乱写”这些环节上。所以这篇内容不仅仅是告诉你点几下鼠标、敲几行命令我会把我这些年带新人、做项目迁移时积累的所有实操细节和避坑经验都揉进去。无论你是刚接触版本控制的学生还是需要将老项目迁移到新平台的经验开发者这篇详尽的指南都能让你在半小时内清晰、无误地完成整个上传流程并理解每一步背后的逻辑。2. 前期准备工具与环境配置在真正动手上传代码之前我们需要把“战场”打扫干净把“武器”准备好。这里主要涉及两个核心工具Git 和 Gitee 账户。很多教程会假设你已经装好了但根据我的经验恰恰是安装和配置这一步能筛掉一半的求助者。2.1 Git的安装与基础配置Git是这一切的基石它是一个分布式版本控制系统。你可以把它理解成一个超级智能的“时光机”兼“协作白板”。它不仅能记录你项目文件中每一个字符的改动历史时光机还能让多个人在同一份代码上并行工作最后优雅地合并协作白板。安装步骤对于Windows用户我强烈建议直接去 Git 官网下载安装程序。安装过程中有几个选项需要注意选择默认编辑器如果你不熟悉Vim请务必选择你常用的编辑器比如VS Code或Notepad否则后面写提交信息时可能会被困在一个你完全不会操作的界面里。调整PATH环境选择“Git from the command line and also from 3rd-party software”。这会把Git添加到你的系统环境变量让你能在任何命令行窗口如CMD、PowerShell中直接使用git命令。行尾转换选择“Checkout Windows-style, commit Unix-style line endings”。这个设置能很好地处理Windows和Linux/Unix系统之间换行符的差异避免合作时出现大量无意义的格式改动。安装完成后打开命令行CMD或Git Bash通过两个命令来配置你的全局身份标识。这非常重要因为你的每一次代码提交都会带上这个“签名”。git config --global user.name “你的用户名” git config --global user.email “你的邮箱地址”这里的用户名和邮箱最好与你在Gitee上注册的信息保持一致这样在仓库的贡献者图表里显示会更清晰。注意--global参数意味着这是全局配置对你这台电脑上所有的Git仓库生效。如果你某个特定项目想用不同的身份可以在那个项目目录里去掉--global再配置一次。2.2 Gitee账户准备与SSH公钥配置接下来是Gitee端的准备。如果你还没有账户去官网注册一个过程很简单。关键在于SSH公钥配置这是实现免密推送代码的关键也是新手最容易出错的地方。为什么用SSH而不是HTTPSHTTPS每次推送都需要输入账号密码虽然现在可以凭据管理但SSH通过密钥对验证的方式更安全、更便捷一次配置长期受益。生成SSH密钥对在你的命令行中执行以下命令ssh-keygen -t rsa -C “你的邮箱地址”执行后它会询问你密钥保存的位置直接按回车使用默认路径C:\Users\你的用户名\.ssh\id_rsa即可。接着会询问你是否为密钥设置密码passphrase如果你对安全性要求不是极高可以直接回车留空这样以后使用就完全不用输密码了。将公钥添加到Gitee生成成功后在默认路径下你会找到两个文件id_rsa私钥绝不能泄露和id_rsa.pub公钥。用文本编辑器打开id_rsa.pub复制里面的全部内容。 然后登录Gitee点击头像 - 设置 - SSH公钥。在“添加公钥”页面标题可以自拟如“My Laptop”将刚才复制的公钥内容粘贴进“公钥”文本框最后点击“确定”。验证是否成功在命令行输入ssh -T gitgitee.com如果看到类似“Hi XXX! You‘ve successfully authenticated...”的欢迎信息就说明配置成功了。如果看到“permission denied”等错误请检查公钥是否完整复制开头是ssh-rsa结尾是你的邮箱或者尝试重新添加一次。3. 核心操作流程详解环境配置妥当后我们就进入核心的上传操作环节。这个过程可以清晰地分为四个步骤在Gitee创建远程仓库、在本地初始化Git仓库、建立本地与远程的链接、最后推送代码。我会为每个步骤配上详细的命令和意图解释。3.1 第一步在Gitee创建远程仓库你可以把Gitee上的仓库想象成云端的一个空房子我们待会儿要把本地的东西搬进去。登录Gitee点击右上角“”号选择“新建仓库”。仓库名称起一个能清晰表达项目内容的名字比如my-awesome-project。路径它会根据仓库名自动生成一般不用改。介绍简单写一下项目是干什么的利于后续传播。公开/私有根据项目性质选择。私有仓库只有你和你邀请的人能看到。初始化设置这里有个关键点除非你这个项目是全新的本地没有任何文件否则千万不要勾选“使用Readme文件初始化仓库”、“设置模板”或“选择分支模型”。因为如果你勾选了Gitee会先创建一个提交比如一个README.md文件导致远程仓库不是一个“空房子”而是一个已经有了一点东西的房子。这会在后续链接本地仓库时因为历史不一致而产生冲突需要先进行合并操作对新手极不友好。我们的目标是推送一个完整的本地项目所以保持远程仓库的“纯净空置”状态是最佳选择。点击“创建”你的远程仓库就建好了。创建成功后页面会显示仓库的地址有HTTPS和SSH两种我们复制SSH地址形如gitgitee.com:yourname/your-repo.git。3.2 第二步初始化本地Git仓库并关联远程现在回到你的本地项目文件夹。假设你的项目根目录是D:\projects\my-project。打开命令行导航到你的项目根目录cd D:\projects\my-project执行Git初始化命令这个命令会在当前目录创建一个隐藏的.git文件夹它是Git用来跟踪管理版本的所有元数据所在。git init将远程仓库地址告诉本地仓库。这里使用上一步复制的SSH地址。git remote add origin gitgitee.com:yourname/your-repo.git这里的origin是一个别名它代表了你刚刚添加的那个远程仓库地址。你可以叫它别的名字但origin是约定俗成的默认名称。3.3 第三步文件添加与首次提交在推送之前我们需要把本地的文件“打包”成一个Git认可的“包裹”提交。检查状态首先用git status命令看看当前工作区有哪些文件发生了变化。红色显示的文件是未被跟踪新文件或已修改但未暂存的文件。添加文件到暂存区暂存区Stage可以理解为一个打包准备区。你可以选择性地添加文件。添加所有新文件和修改过的文件git add .注意后面有个点添加特定文件git add filename1 filename2实操心得不建议长期使用git add .尤其是在项目大了以后。这容易把一些编译产生的临时文件如node_modules/,*.log,.idea/或配置文件包含密码也提交上去。最佳实践是使用.gitignore文件预先排除这些文件然后再用git add .。现在你可以先执行git add .完成首次提交。创建提交将暂存区的内容打包成一个永久的“包裹”并附上说明。git commit -m “这里是你的提交信息”提交信息怎么写这是体现专业性的地方。切忌写“更新”、“修复bug”这种模糊的话。好的提交信息应该简明扼要地概括本次提交的目的。例如“feat: 添加用户登录功能”、“fix: 修复首页图片无法加载的问题”、“docs: 更新API接口说明文档”。可以参考“约定式提交”规范让历史记录一目了然。3.4 第四步推送至远程仓库本地“包裹”打好远程“地址”也知道现在就是发货的时候了。git push -u origin masterpush推送命令。-u这是--set-upstream的简写。它有两个作用一是将本地的master分支与远程的origin/master分支关联起来二是设置上游跟踪。设置之后以后在这个分支上你只需要简单地输入git push或git pullGit就知道是和哪个远程分支交互了非常方便。origin我们之前设置的远程仓库别名。master你要推送的本地分支名。现在主分支名称更推荐使用main但Gitee默认创建的分支仍是master根据实际情况调整即可。执行后命令行会显示推送进度。完成后刷新你的Gitee仓库页面就能看到所有代码已经安静地躺在那里了。4. 进阶操作与最佳实践如果只是完成一次推送上面的步骤就够了。但要想真正用好Git和Gitee让团队协作顺畅项目历史清晰还需要掌握以下进阶操作和规范。4.1 使用.gitignore文件管理忽略项这是维护仓库清洁度的第一道防线。.gitignore文件是一个纯文本文件放在项目根目录里面列出了所有你希望Git忽略、不进行跟踪的文件和目录模式。为什么要用避免提交依赖库如node_modules/,vendor/这些可以通过包管理器重新安装提交它们会让仓库体积巨大无比。避免提交IDE配置文件如.idea/,.vscode/这些配置因人而异。避免提交编译产物如dist/,build/,*.class和系统文件如.DS_Store Thumbs.db。如何创建在项目根目录新建一个名为.gitignore的文件。你可以根据项目类型去 GitHub 的 gitignore 模板仓库找到对应的模板如Python.gitignore,Java.gitignore复制内容过来再根据自己项目情况微调。示例一个前端Node.js项目可能包含的# 依赖目录 node_modules/ npm-debug.log* # IDE .vscode/ .idea/ # 环境变量文件通常包含敏感信息 .env .env.local # 构建输出目录 dist/ build/ *.exe重要提示.gitignore文件本身是需要被提交到仓库的这样所有克隆该项目的人都能共享同一套忽略规则。并且它只对未被跟踪的文件生效。如果一个文件已经被Git跟踪即之前被add和commit过那么即使后来把它加入.gitignoreGit依然会继续跟踪它的变化。此时需要先用git rm --cached filename命令将其从Git索引中移除但保留在本地磁盘再提交。4.2 分支策略与协作模型对于个人项目可能一直用master分支就够了。但对于稍正式的项目或团队协作良好的分支策略是必需的。主分支master/main这个分支的代码永远处于稳定、可发布的状态。任何直接在这个分支上的开发都是高危行为。功能分支feature branches这是最常用的分支。当你需要开发一个新功能比如“用户支付”时应该从master分支拉出一个新分支例如feature/user-payment。在这个分支上尽情开发、提交。完成并通过测试后通过Pull RequestPR或合并请求MR的方式将其合并回master分支。Gitee提供了非常友好的Web界面来进行代码审查和合并。操作流程创建并切换到功能分支git checkout -b feature/user-payment在该分支上进行多次add和commit。开发完成后推送到远程git push origin feature/user-payment登录Gitee在仓库页面你会看到提示可以创建合并请求。通过Web界面发起请求指定将feature/user-payment合并到master。可以邀请同事进行代码评审Code Review。评审通过后在Gitee上点击“合并”。这样功能就被安全地集成到了主分支。这种模式保证了主分支的纯洁性也便于并行开发和问题追溯。4.3 提交信息的规范化混乱的提交信息是项目历史的灾难。前面提到过“约定式提交”这里展开一下。一个结构化的提交信息通常包括类型Type说明提交的类别。feat新功能fix修复bugdocs文档更新style代码格式调整不影响逻辑refactor代码重构既非新增功能也非修复bugtest增加或修改测试chore构建过程或辅助工具的变动范围Scope可选说明提交影响的范围比如某个模块或文件。主题Subject对本次提交目的的简短描述以动词开头不使用句号。格式示例feat(用户模块): 新增手机号绑定功能 fix(登录API): 修复验证码在特定情况下失效的问题 docs(README): 更新项目快速启动指南养成这样的习惯当你使用git log --oneline查看历史或者需要回溯某个功能是何时引入、某个bug是何时修复的时候会感到无比舒心。5. 常见问题与故障排查实录即使步骤再详细实操中还是会遇到各种“拦路虎”。下面是我总结的几个最常见的问题及其解决方案。5.1 推送失败权限被拒绝Permission Denied这是SSH配置问题的高发区。症状git push时出现Permission denied (publickey).或Could not read from remote repository.排查步骤确认公钥已添加再次登录Gitee检查SSH公钥列表里是否有你的设备公钥且内容完整无误。测试SSH连接运行ssh -T gitgitee.com。如果失败说明本地SSH代理可能没有加载你的私钥。启动SSH代理并添加密钥# 启动代理 eval $(ssh-agent -s) # 将你的默认私钥添加到代理 ssh-add ~/.ssh/id_rsaWindows用户如果使用Git Bash命令相同如果使用CMD可能需要使用ssh-agent的完整路径。检查远程地址运行git remote -v确认远程地址是SSH格式gitgitee.com:...而非HTTPS格式https://gitee.com/...。如果是HTTPS用git remote set-url origin gitgitee.com:yourname/your-repo.git修改。5.2 推送失败非快进式更新Non-fast-forward这是分支历史冲突的典型错误。症状git push时出现[rejected] master - master (non-fast-forward)原因在你上次拉取代码之后远程仓库的master分支已经有了新的提交可能是你自己在别的电脑上推的也可能是协作者推的。你的本地历史与远程历史分叉了Git拒绝简单的覆盖。解决方案永远不要使用git push -f强制推送来覆盖远程历史除非你百分百确定只有你一人在工作且愿意丢弃远程的更改。正确的做法是先将远程的最新变更拉取到本地并合并git pull origin master这条命令相当于git fetch获取远程更新 git merge合并到本地分支。如果遇到合并冲突Git会提示你哪些文件冲突了。你需要手动打开这些文件解决冲突删除Git留下的,,标记保留正确的代码。解决冲突后将文件标记为已解决并提交git add . git commit -m “merge: 合并远程master分支”再次推送git push origin master。5.3 误提交了敏感信息或大文件这是两个不同但都很严重的问题。敏感信息如密码、密钥如果已经提交并推送仅仅在后续提交中删除文件是不够的因为历史记录里仍然存在。必须从Git历史中彻底清除。这需要使用git filter-branch或BFG Repo-Cleaner这样的工具来重写历史操作复杂且有风险。最佳实践是预防使用.env文件存储环境变量并将其加入.gitignore使用Git的git-secret等工具加密敏感文件。大文件如视频、数据集Git不适合管理二进制大文件会导致仓库体积膨胀拉取和克隆极慢。如果误提交同样需要从历史中清除。Gitee提供了Git LFS大文件存储扩展来专门管理这类文件。对于已经误传的大文件清除历史是唯一办法可以考虑在清理后使用git lfs track命令来正确跟踪它们。5.4 克隆仓库与后续协作当你需要将Gitee上已有的项目拿到本地新电脑上开发时使用克隆命令git clone gitgitee.com:yourname/your-repo.git这会在当前目录下创建一个以仓库名命名的文件夹并自动完成远程仓库地址的配置origin。后续的日常协作流程通常是开始工作前先拉取最新代码git pull如果设置了上游跟踪或git pull origin master。在本地进行修改、开发。将修改添加到暂存区git add .或选择性添加。提交到本地仓库git commit -m “清晰的提交信息”。推送到远程仓库git push。这个“拉取-修改-提交-推送”的循环就是最基本的分布式协作模式。掌握它你就掌握了使用Git进行版本控制和团队协作的钥匙。整个过程的核心在于理解本地与远程仓库的同步关系以及通过提交来构建清晰可追溯的项目历史。 1. 项目概述与核心价值每次看到同事或朋友还在用U盘或者微信传来传去地分享代码或者对着自己电脑里一堆版本混乱的项目文件夹头疼时我就特别想跟他们聊聊代码仓库托管这件事。今天要聊的就是把你的本地项目稳稳当当地上传到Gitee仓库的完整流程。Gitee也就是码云是国内一个非常主流的代码托管平台对于咱们国内的开发者来说访问速度快、社区活跃而且完全符合本地化的开发需求是GitHub一个非常优秀的替代或补充选择。这个操作听起来基础但里面门道不少。从最开始的Git环境准备到中间可能遇到的各类报错处理再到最后如何建立一个清晰、规范的提交历史每一步都藏着新手容易踩的坑。我见过太多人卡在“秘钥配置不对”、“远程仓库地址搞错”或者“提交信息乱写”这些环节上。所以这篇内容不仅仅是告诉你点几下鼠标、敲几行命令我会把我这些年带新人、做项目迁移时积累的所有实操细节和避坑经验都揉进去。无论你是刚接触版本控制的学生还是需要将老项目迁移到新平台的经验开发者这篇详尽的指南都能让你在半小时内清晰、无误地完成整个上传流程并理解每一步背后的逻辑。2. 前期准备工具与环境配置在真正动手上传代码之前我们需要把“战场”打扫干净把“武器”准备好。这里主要涉及两个核心工具Git 和 Gitee 账户。很多教程会假设你已经装好了但根据我的经验恰恰是安装和配置这一步能筛掉一半的求助者。2.1 Git的安装与基础配置Git是这一切的基石它是一个分布式版本控制系统。你可以把它理解成一个超级智能的“时光机”兼“协作白板”。它不仅能记录你项目文件中每一个字符的改动历史时光机还能让多个人在同一份代码上并行工作最后优雅地合并协作白板。安装步骤对于Windows用户我强烈建议直接去 Git 官网下载安装程序。安装过程中有几个选项需要注意选择默认编辑器如果你不熟悉Vim请务必选择你常用的编辑器比如VS Code或Notepad否则后面写提交信息时可能会被困在一个你完全不会操作的界面里。调整PATH环境选择“Git from the command line and also from 3rd-party software”。这会把Git添加到你的系统环境变量让你能在任何命令行窗口如CMD、PowerShell中直接使用git命令。行尾转换选择“Checkout Windows-style, commit Unix-style line endings”。这个设置能很好地处理Windows和Linux/Unix系统之间换行符的差异避免合作时出现大量无意义的格式改动。安装完成后打开命令行CMD或Git Bash通过两个命令来配置你的全局身份标识。这非常重要因为你的每一次代码提交都会带上这个“签名”。git config --global user.name “你的用户名” git config --global user.email “你的邮箱地址”这里的用户名和邮箱最好与你在Gitee上注册的信息保持一致这样在仓库的贡献者图表里显示会更清晰。注意--global参数意味着这是全局配置对你这台电脑上所有的Git仓库生效。如果你某个特定项目想用不同的身份可以在那个项目目录里去掉--global再配置一次。2.2 Gitee账户准备与SSH公钥配置接下来是Gitee端的准备。如果你还没有账户去官网注册一个过程很简单。关键在于SSH公钥配置这是实现免密推送代码的关键也是新手最容易出错的地方。为什么用SSH而不是HTTPSHTTPS每次推送都需要输入账号密码虽然现在可以凭据管理但SSH通过密钥对验证的方式更安全、更便捷一次配置长期受益。生成SSH密钥对在你的命令行中执行以下命令ssh-keygen -t rsa -C “你的邮箱地址”执行后它会询问你密钥保存的位置直接按回车使用默认路径C:\Users\你的用户名\.ssh\id_rsa即可。接着会询问你是否为密钥设置密码passphrase如果你对安全性要求不是极高可以直接回车留空这样以后使用就完全不用输密码了。将公钥添加到Gitee生成成功后在默认路径下你会找到两个文件id_rsa私钥绝不能泄露和id_rsa.pub公钥。用文本编辑器打开id_rsa.pub复制里面的全部内容。 然后登录Gitee点击头像 - 设置 - SSH公钥。在“添加公钥”页面标题可以自拟如“My Laptop”将刚才复制的公钥内容粘贴进“公钥”文本框最后点击“确定”。验证是否成功在命令行输入ssh -T gitgitee.com如果看到类似“Hi XXX! You‘ve successfully authenticated...”的欢迎信息就说明配置成功了。如果看到“permission denied”等错误请检查公钥是否完整复制开头是ssh-rsa结尾是你的邮箱或者尝试重新添加一次。3. 核心操作流程详解环境配置妥当后我们就进入核心的上传操作环节。这个过程可以清晰地分为四个步骤在Gitee创建远程仓库、在本地初始化Git仓库、建立本地与远程的链接、最后推送代码。我会为每个步骤配上详细的命令和意图解释。3.1 第一步在Gitee创建远程仓库你可以把Gitee上的仓库想象成云端的一个空房子我们待会儿要把本地的东西搬进去。登录Gitee点击右上角“”号选择“新建仓库”。仓库名称起一个能清晰表达项目内容的名字比如my-awesome-project。路径它会根据仓库名自动生成一般不用改。介绍简单写一下项目是干什么的利于后续传播。公开/私有根据项目性质选择。私有仓库只有你和你邀请的人能看到。初始化设置这里有个关键点除非你这个项目是全新的本地没有任何文件否则千万不要勾选“使用Readme文件初始化仓库”、“设置模板”或“选择分支模型”。因为如果你勾选了Gitee会先创建一个提交比如一个README.md文件导致远程仓库不是一个“空房子”而是一个已经有了一点东西的房子。这会在后续链接本地仓库时因为历史不一致而产生冲突需要先进行合并操作对新手极不友好。我们的目标是推送一个完整的本地项目所以保持远程仓库的“纯净空置”状态是最佳选择。点击“创建”你的远程仓库就建好了。创建成功后页面会显示仓库的地址有HTTPS和SSH两种我们复制SSH地址形如gitgitee.com:yourname/your-repo.git。3.2 第二步初始化本地Git仓库并关联远程现在回到你的本地项目文件夹。假设你的项目根目录是D:\projects\my-project。打开命令行导航到你的项目根目录cd D:\projects\my-project执行Git初始化命令这个命令会在当前目录创建一个隐藏的.git文件夹它是Git用来跟踪管理版本的所有元数据所在。git init将远程仓库地址告诉本地仓库。这里使用上一步复制的SSH地址。git remote add origin gitgitee.com:yourname/your-repo.git这里的origin是一个别名它代表了你刚刚添加的那个远程仓库地址。你可以叫它别的名字但origin是约定俗成的默认名称。3.3 第三步文件添加与首次提交在推送之前我们需要把本地的文件“打包”成一个Git认可的“包裹”提交。检查状态首先用git status命令看看当前工作区有哪些文件发生了变化。红色显示的文件是未被跟踪新文件或已修改但未暂存的文件。添加文件到暂存区暂存区Stage可以理解为一个打包准备区。你可以选择性地添加文件。添加所有新文件和修改过的文件git add .注意后面有个点添加特定文件git add filename1 filename2实操心得不建议长期使用git add .尤其是在项目大了以后。这容易把一些编译产生的临时文件如node_modules/,*.log,.idea/或配置文件包含密码也提交上去。最佳实践是使用.gitignore文件预先排除这些文件然后再用git add .。现在你可以先执行git add .完成首次提交。创建提交将暂存区的内容打包成一个永久的“包裹”并附上说明。git commit -m “这里是你的提交信息”提交信息怎么写这是体现专业性的地方。切忌写“更新”、“修复bug”这种模糊的话。好的提交信息应该简明扼要地概括本次提交的目的。例如“feat: 添加用户登录功能”、“fix: 修复首页图片无法加载的问题”、“docs: 更新API接口说明文档”。可以参考“约定式提交”规范让历史记录一目了然。3.4 第四步推送至远程仓库本地“包裹”打好远程“地址”也知道现在就是发货的时候了。git push -u origin masterpush推送命令。-u这是--set-upstream的简写。它有两个作用一是将本地的master分支与远程的origin/master分支关联起来二是设置上游跟踪。设置之后以后在这个分支上你只需要简单地输入git push或git pullGit就知道是和哪个远程分支交互了非常方便。origin我们之前设置的远程仓库别名。master你要推送的本地分支名。现在主分支名称更推荐使用main但Gitee默认创建的分支仍是master根据实际情况调整即可。执行后命令行会显示推送进度。完成后刷新你的Gitee仓库页面就能看到所有代码已经安静地躺在那里了。4. 进阶操作与最佳实践如果只是完成一次推送上面的步骤就够了。但要想真正用好Git和Gitee让团队协作顺畅项目历史清晰还需要掌握以下进阶操作和规范。4.1 使用.gitignore文件管理忽略项这是维护仓库清洁度的第一道防线。.gitignore文件是一个纯文本文件放在项目根目录里面列出了所有你希望Git忽略、不进行跟踪的文件和目录模式。为什么要用避免提交依赖库如node_modules/,vendor/这些可以通过包管理器重新安装提交它们会让仓库体积巨大无比。避免提交IDE配置文件如.idea/,.vscode/这些配置因人而异。避免提交编译产物如dist/,build/,*.class和系统文件如.DS_Store Thumbs.db。如何创建在项目根目录新建一个名为.gitignore的文件。你可以根据项目类型去 GitHub 的 gitignore 模板仓库找到对应的模板如Python.gitignore,Java.gitignore复制内容过来再根据自己项目情况微调。示例一个前端Node.js项目可能包含的# 依赖目录 node_modules/ npm-debug.log* # IDE .vscode/ .idea/ # 环境变量文件通常包含敏感信息 .env .env.local # 构建输出目录 dist/ build/ *.exe重要提示.gitignore文件本身是需要被提交到仓库的这样所有克隆该项目的人都能共享同一套忽略规则。并且它只对未被跟踪的文件生效。如果一个文件已经被Git跟踪即之前被add和commit过那么即使后来把它加入.gitignoreGit依然会继续跟踪它的变化。此时需要先用git rm --cached filename命令将其从Git索引中移除但保留在本地磁盘再提交。4.2 分支策略与协作模型对于个人项目可能一直用master分支就够了。但对于稍正式的项目或团队协作良好的分支策略是必需的。主分支master/main这个分支的代码永远处于稳定、可发布的状态。任何直接在这个分支上的开发都是高危行为。功能分支feature branches这是最常用的分支。当你需要开发一个新功能比如“用户支付”时应该从master分支拉出一个新分支例如feature/user-payment。在这个分支上尽情开发、提交。完成并通过测试后通过Pull RequestPR或合并请求MR的方式将其合并回master分支。Gitee提供了非常友好的Web界面来进行代码审查和合并。操作流程创建并切换到功能分支git checkout -b feature/user-payment在该分支上进行多次add和commit。开发完成后推送到远程git push origin feature/user-payment登录Gitee在仓库页面你会看到提示可以创建合并请求。通过Web界面发起请求指定将feature/user-payment合并到master。可以邀请同事进行代码评审Code Review。评审通过后在Gitee上点击“合并”。这样功能就被安全地集成到了主分支。这种模式保证了主分支的纯洁性也便于并行开发和问题追溯。4.3 提交信息的规范化混乱的提交信息是项目历史的灾难。前面提到过“约定式提交”这里展开一下。一个结构化的提交信息通常包括类型Type说明提交的类别。feat新功能fix修复bugdocs文档更新style代码格式调整不影响逻辑refactor代码重构既非新增功能也非修复bugtest增加或修改测试chore构建过程或辅助工具的变动范围Scope可选说明提交影响的范围比如某个模块或文件。主题Subject对本次提交目的的简短描述以动词开头不使用句号。格式示例feat(用户模块): 新增手机号绑定功能 fix(登录API): 修复验证码在特定情况下失效的问题 docs(README): 更新项目快速启动指南养成这样的习惯当你使用git log --oneline查看历史或者需要回溯某个功能是何时引入、某个bug是何时修复的时候会感到无比舒心。5. 常见问题与故障排查实录即使步骤再详细实操中还是会遇到各种“拦路虎”。下面是我总结的几个最常见的问题及其解决方案。5.1 推送失败权限被拒绝Permission Denied这是SSH配置问题的高发区。症状git push时出现Permission denied (publickey).或Could not read from remote repository.排查步骤确认公钥已添加再次登录Gitee检查SSH公钥列表里是否有你的设备公钥且内容完整无误。测试SSH连接运行ssh -T gitgitee.com。如果失败说明本地SSH代理可能没有加载你的私钥。启动SSH代理并添加密钥# 启动代理 eval $(ssh-agent -s) # 将你的默认私钥添加到代理 ssh-add ~/.ssh/id_rsaWindows用户如果使用Git Bash命令相同如果使用CMD可能需要使用ssh-agent的完整路径。检查远程地址运行git remote -v确认远程地址是SSH格式gitgitee.com:...而非HTTPS格式https://gitee.com/...。如果是HTTPS用git remote set-url origin gitgitee.com:yourname/your-repo.git修改。5.2 推送失败非快进式更新Non-fast-forward这是分支历史冲突的典型错误。症状git push时出现[rejected] master - master (non-fast-forward)原因在你上次拉取代码之后远程仓库的master分支已经有了新的提交可能是你自己在别的电脑上推的也可能是协作者推的。你的本地历史与远程历史分叉了Git拒绝简单的覆盖。解决方案永远不要使用git push -f强制推送来覆盖远程历史除非你百分百确定只有你一人在工作且愿意丢弃远程的更改。正确的做法是先将远程的最新变更拉取到本地并合并git pull origin master这条命令相当于git fetch获取远程更新 git merge合并到本地分支。如果遇到合并冲突Git会提示你哪些文件冲突了。你需要手动打开这些文件解决冲突删除Git留下的,,标记保留正确的代码。解决冲突后将文件标记为已解决并提交git add . git commit -m “merge: 合并远程master分支”再次推送git push origin master。5.3 误提交了敏感信息或大文件这是两个不同但都很严重的问题。敏感信息如密码、密钥如果已经提交并推送仅仅在后续提交中删除文件是不够的因为历史记录里仍然存在。必须从Git历史中彻底清除。这需要使用git filter-branch或BFG Repo-Cleaner这样的工具来重写历史操作复杂且有风险。最佳实践是预防使用.env文件存储环境变量并将其加入.gitignore使用Git的git-secret等工具加密敏感文件。大文件如视频、数据集Git不适合管理二进制大文件会导致仓库体积膨胀拉取和克隆极慢。如果误提交同样需要从历史中清除。Gitee提供了Git LFS大文件存储扩展来专门管理这类文件。对于已经误传的大文件清除历史是唯一办法可以考虑在清理后使用git lfs track命令来正确跟踪它们。5.4 克隆仓库与后续协作当你需要将Gitee上已有的项目拿到本地新电脑上开发时使用克隆命令git clone gitgitee.com:yourname/your-repo.git这会在当前目录下创建一个以仓库名命名的文件夹并自动完成远程仓库地址的配置origin。后续的日常协作流程通常是开始工作前先拉取最新代码git pull如果设置了上游跟踪或git pull origin master。在本地进行修改、开发。将修改添加到暂存区git add .或选择性添加。提交到本地仓库git commit -m “清晰的提交信息”。推送到远程仓库git push。这个“拉取-修改-提交-推送”的循环就是最基本的分布式协作模式。掌握它你就掌握了使用Git进行版本控制和团队协作的钥匙。整个过程的核心在于理解本地与远程仓库的同步关系以及通过提交来构建清晰可追溯的项目历史。 
