1. 项目概述为什么你需要掌握Git与Gitee如果你刚开始接触代码协作或者只是想把本地写好的项目找个地方安全地存起来那么“Git”和“Gitee”这两个词一定绕不开。很多人觉得它们听起来很“极客”是程序员专属其实不然。简单来说Git是一个帮你管理文件所有修改历史的工具而Gitee码云是一个存放这些文件历史的“网络硬盘”。想象一下你写一份重要的报告每次修改都另存为一个新文件很快桌面就堆满了“报告V1”、“报告V2最终版”、“报告V2真的最终版”。Git就是那个帮你自动记录每一次修改内容、并能随时回到任何一个“最终版”的智能管家。Gitee则提供了一个云端保险柜让你可以和同事同时编辑这份报告且每个人的修改都能清晰合并再也不用通过微信来回发送压缩包了。这个教程的目标非常直接让你从零开始完成Git的安装配置学会将Gitee上的项目下载到本地修改文件后再将更新同步回云端。这涵盖了个人开发与团队协作中最核心的“拉取-修改-提交-推送”工作流。无论你是学生需要管理课程作业还是职场新人需要参与团队项目这套流程都是必备的基础技能。整个过程不涉及复杂的分支管理只聚焦于最常用、最实用的几个命令和操作确保你学完就能立刻用上。2. 环境准备与核心概念扫盲在动手之前我们需要把“战场”打扫干净并理解几个关键名词。这能让你后续的每一步操作都心中有数而不是机械地复制命令。2.1 Git的安装与基础配置Git本身是一个命令行工具我们需要先把它安装到你的电脑上。Windows用户前往 Git 官网下载安装程序。安装过程中有几个选项需要注意选择默认编辑器如果你不熟悉Vim强烈建议选择你常用的编辑器比如VSCode或Notepad避免后续提交信息时陷入Vim的编辑模式不知所措。调整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/macOS系统间换行符的差异避免协作时出现大量无意义的文件更改提示。macOS用户最简单的方法是安装Xcode Command Line Tools。打开终端Terminal输入xcode-select --install并按照提示操作即可。也可以通过Homebrew安装brew install git。Linux用户通过包管理器安装例如Ubuntu/Debian系sudo apt-get install git。安装完成后打开终端Windows用户可使用Git Bash或系统自带的PowerShell进行全局身份配置这是你提交代码时的“签名”git config --global user.name 你的用户名 git config --global user.email 你的邮箱这里的邮箱最好与你在Gitee上注册的邮箱一致这样你的提交记录才能正确关联到你的Gitee账户。2.2 理解核心概念仓库、提交、远程仓库Repository简称Repo可以理解为一个受Git管理的项目文件夹。里面不仅包含你的项目文件还有一个隐藏的.git目录用来记录所有的历史版本信息。提交Commit这是Git中最核心的操作。它不是一个简单的保存动作而是对你当前工作状态的一次快照。每次提交都需要附上一条说明信息Commit Message描述这次修改做了什么。好的提交信息像日记一样能让你在未来快速理解每次更改的意图。工作区、暂存区、仓库这是Git的三个重要区域。工作区就是你电脑上直接能看到、编辑的文件。暂存区Stage/Index一个中间区域。你可以选择将工作区的哪些修改放入暂存区准备打包成一次提交。仓库本地存放所有已提交的快照。只有从暂存区提交过来的内容才会永久存入历史。远程仓库Remote Repository就是托管在Gitee、GitHub等平台上的云端仓库。它的作用是同步和备份。你从远程仓库“拉取”Pull最新代码到本地在本地修改并提交后再“推送”Push到远程仓库完成一次完整的协作循环。2.3 Gitee账号注册与仓库创建访问Gitee官网使用邮箱或手机号注册一个账号。登录后点击页面右上角的“”号选择“新建仓库”。创建仓库时有几个关键选项仓库名称尽量用英文清晰易懂例如my-first-project。仓库介绍简单描述项目是做什么的。是否开源选择“公开”意味着所有人都能看到你的代码选择“私有”则只有你和你邀请的成员可见。对于学习项目选择“公开”即可。初始化仓库这里非常关键。对于纯新手我强烈建议不要勾选“使用Readme文件初始化这个仓库”。因为一个空的远程仓库会给你最清晰的指令告诉你如何将本地已有的项目推送到云端或者如何从零开始克隆。我们先从最基础的手动操作学起。.gitignore可以先不选后续我们会手动添加。开源许可证如果是学习项目可以暂时忽略。点击“创建”后一个空的远程仓库就准备好了。页面会显示一些命令行指引我们稍后会用到。3. 核心操作流程从下载到更改上传现在我们进入实战环节。整个过程可以概括为克隆 - 修改 - 暂存 - 提交 - 推送。3.1 第一步将远程仓库克隆到本地Clone“克隆”是整个流程的起点它的作用是在你的本地电脑上创建一个与远程仓库一模一样的副本并且自动建立好关联。假设你在Gitee上创建了一个名为my-first-project的空仓库其仓库地址HTTPS格式类似https://gitee.com/你的用户名/my-first-project.git。在你的电脑上找一个合适的位置比如D:\Projects或~/Documents/Code。打开终端使用cd命令进入这个目录。执行克隆命令git clone https://gitee.com/你的用户名/my-first-project.git命令执行后当前目录下会生成一个与仓库同名的文件夹my-first-project。进入这个文件夹你就进入了本地仓库的工作区。注意首次使用HTTPS方式克隆时可能会弹出Gitee的登录窗口要求验证身份。你也可以配置SSH密钥来实现免密操作这更安全便捷我们会在后面详细说明。3.2 第二步在本地进行文件更改现在你可以在本地仓库文件夹里做任何事了新建文件、修改文件、删除文件。我们模拟一个最简单的操作在my-first-project文件夹内新建一个文本文档命名为hello.txt。用编辑器打开hello.txt输入一行文字“Hello, Git and Gitee!”然后保存。此时你的修改仅存在于工作区。Git已经察觉到了变化但还没有正式记录。3.3 第三步暂存与提交更改接下来我们需要将工作区的改动正式记录到本地仓库的历史中。这个过程分两步检查状态在动手前先用git status命令查看当前仓库的状态。它会清晰地告诉你哪些文件被修改了、哪些是新文件、哪些文件已处于暂存区。这是一个非常实用的命令建议在每次操作前都习惯性使用一下。git status你会看到hello.txt被标记为“Untracked files”未跟踪的文件。暂存更改使用git add命令将文件的改动添加到暂存区。你可以添加单个文件也可以添加所有改动。添加单个文件git add hello.txt添加所有改动git add .注意后面有一个点 再次运行git status你会看到hello.txt变成了绿色显示“Changes to be committed”意味着它已在暂存区等待被提交。提交更改使用git commit命令将暂存区的内容打包成一个永久的快照保存到本地仓库。git commit -m “添加了hello.txt问候文件”-m参数后面跟的是本次提交的说明信息。务必养成撰写清晰、简洁提交信息的习惯例如“修复了登录按钮点击无效的bug”、“新增了用户个人资料页面的头像上传功能”。模糊的“更新”或“修改”会为日后回溯历史带来巨大困难。至此你的更改已经安全地保存在了本地Git仓库的历史记录中。你可以随时回退到这个版本。3.4 第四步将本地提交推送到远程仓库Push本地提交只存在于你的电脑上。为了同步到Gitee让其他人能看到或备份需要执行推送操作。git push origin mainpush推送命令。origin这是远程仓库的默认别名指向你最初克隆的那个Gitee仓库地址。main这是主分支的名称早期默认是master现在主流已改为main。它代表你要推送到的远程分支。执行后Git会要求你输入Gitee的用户名和密码如果使用HTTPS方式。成功后刷新你的Gitee仓库页面就能看到hello.txt文件已经出现在仓库文件列表中了。实操心得git push是单向的只将你的本地提交“上传”到远程。如果在此期间其他协作者已经向远程仓库推送了新的提交那么你的这次推送可能会被拒绝。这时你需要先执行git pull拉取远程的更新在本地合并后再推送。这是团队协作中最常见的场景之一。4. 进阶技巧与高效配置掌握了基本流程后下面这些技巧能让你用得更顺手、更专业。4.1 配置SSH密钥实现免密操作每次推送都要输密码很麻烦使用SSH密钥对可以一劳永逸。其原理是在你的电脑上生成一把“私钥”自己保管好将对应的“公钥”交给Gitee。之后每次连接双方用密钥自动验证身份。生成SSH密钥对如果已有~/.ssh/id_rsa.pub文件可跳过ssh-keygen -t rsa -C “你的邮箱”连续按回车接受默认保存路径和不设置密码为方便起见学习环境可不设密码。查看并复制公钥cat ~/.ssh/id_rsa.pub复制终端输出的以ssh-rsa开头的一长串内容。在Gitee中添加公钥登录Gitee点击头像 - 设置 - SSH公钥。标题栏可以随意填写如“My Laptop”。将复制的公钥内容粘贴到“公钥”栏中点击“确定”。测试连接ssh -T gitgitee.com看到“Hi XXX! Youve successfully authenticated...”的欢迎信息即表示成功。将远程仓库地址改为SSH格式 对于之前用HTTPS克隆的仓库可以修改其远程地址git remote set-url origin gitgitee.com:你的用户名/仓库名.git之后再进行git push或git pull就不再需要输入密码了。4.2 使用.gitignore文件排除无用文件项目中总有一些文件不需要纳入版本管理比如编译产生的二进制文件、IDE的配置文件、本地环境变量文件、系统生成的缩略图等。.gitignore文件就是用来定义这些忽略规则的。在仓库根目录下创建一个名为.gitignore的文件注意开头有个点。在文件中按行添加需要忽略的文件或文件夹模式。例如# 忽略所有 .log 文件 *.log # 忽略 node_modules 整个目录 node_modules/ # 忽略名为 .env 的本地环境配置文件 .env # 忽略操作系统生成的缩略图文件 .DS_Store将这个.gitignore文件本身通过git add和git commit提交到仓库。这样所有协作者都会共享同一套忽略规则。重要提示.gitignore只能忽略那些尚未被Git跟踪的文件。如果一个文件已经被提交过即已被跟踪那么即使后来将其加入.gitignoreGit依然会继续跟踪它的变化。此时需要先用git rm --cached file命令将其从Git索引中移除但不删除本地文件再提交。4.3 使用图形化工具辅助如VSCode如果你不习惯命令行使用集成了Git功能的编辑器会直观很多。以VSCode为例安装VSCode后用VSCode打开你的项目文件夹。左侧活动栏有一个源代码管理图标分支形状。点击它所有变更的文件都会列出来。在每个文件后面你可以看到“”号对应git add和“-”号放弃更改。在顶部的输入框填写提交信息然后点击上方的勾号✔即可完成提交。点击“...”更多菜单可以选择“推送到”或“拉取自”远程仓库。图形化工具将Git命令转化为了可视化的按钮和菜单非常适合初学者理解工作流。但了解背后的命令行操作能让你在遇到复杂情况或使用无图形界面的服务器时更加从容。5. 常见问题与故障排查实录在实际操作中你几乎一定会遇到下面这些问题。别担心它们都有标准的解决思路。5.1 提交信息写错了怎么办刚执行完git commit -m “错别字”发现信息写错了。这时可以使用--amend参数修改最近一次提交的信息git commit --amend -m “新的提交信息”这个操作会替换上一次的提交信息而不会产生一个新的提交记录。注意如果该提交已经推送到了远程仓库强制修改后再推送 (git push -f) 会改写远程历史在团队协作中需极其谨慎通常不建议这样做。5.2 文件改乱了想一键还原怎么办你在工作区对hello.txt做了很多实验性修改但现在想彻底放弃这些修改还原到上次提交时的状态git checkout -- hello.txt这个命令非常“危险”且不可逆它会用本地仓库中保存的版本直接覆盖工作区的文件所有未提交的改动都将永久丢失。执行前请务必确认。5.3 不小心把不想提交的文件git add了怎么办文件已经被添加到了暂存区但还没提交。你可以将其从暂存区撤出但保留工作区的修改git reset HEAD hello.txt执行后hello.txt的更改状态会从“Changes to be committed”变回“Changes not staged for commit”或“Untracked”。然后你可以决定是修改.gitignore忽略它还是继续编辑。5.4 执行git push时被拒绝提示“非快进式推送”这是团队协作中的典型问题。意味着在你上次拉取代码后远程仓库已经有了新的提交可能是其他同事推送的。你的本地历史与远程历史出现了分叉。标准解决流程先拉取执行git pull origin main。这会将远程的最新更改拉取到本地并尝试自动合并。解决冲突如果自动合并失败Git会提示“CONFLICT”并在冲突文件中用标记出冲突内容。你需要手动编辑这些文件解决冲突即决定保留哪部分代码或如何整合。重新提交解决所有冲突后使用git add标记冲突已解决然后执行git commit。Git会为你生成一个合并提交。再次推送完成合并后执行git push origin main。核心原则在推送之前永远先拉取一次确保你的本地分支是基于远程的最新版本进行修改的。5.5 如何下载克隆Gitee上别人的项目这其实就是“克隆”操作。在Gitee上找到你感兴趣的项目点击绿色的“克隆/下载”按钮复制提供的HTTPS或SSH地址然后在你的本地终端执行git clone 地址即可。这样你就获得了一份完整的、包含全部历史的项目副本可以自由学习、运行甚至在其基础上进行修改如需贡献通常使用Fork Pull Request流程。整个流程走下来你会发现版本控制的核心思想并不复杂记录快照、管理变更、同步协作。Git和Gitee的强大之处在于它们用一套相对简单的机制优雅地解决了软件开发中代码历史管理这一复杂问题。刚开始可能会觉得命令繁多但只要你牢牢掌握clone,status,add,commit,pull,push这六个核心命令就已经能应对90%的日常场景了。剩下的高级功能可以在需要时再逐步探索。最重要的是现在就开始动手创建一个仓库完成一次从下载到更改再到上传的完整循环实践是掌握工具的唯一捷径。