1. 项目概述为什么你需要一份“终极”Gitee指南如果你刚开始接触代码托管或者从GitHub转向国内平台Gitee码云大概率是你绕不开的一个名字。作为国内领先的代码托管与协作平台它提供了与GitHub类似的核心功能——Git仓库管理、Issue跟踪、Pull Request在Gitee里叫“合并请求”、Wiki文档等但最大的优势在于访问速度快、中文界面友好并且集成了CI/CDGeeK、Pages静态站点等实用服务。网上关于Gitee的教程确实不少但要么是零散的“如何注册”要么是深奥的“Git原理详解”新手看完常常是“眼睛会了手不会”。我花了些时间结合自己从零开始到团队协作的完整经历把Gitee的核心使用链路、高频命令、以及那些官方文档里不会写的“坑”和“技巧”系统地梳理了一遍。这篇内容的目标很明确让你手边有这一份指南就能解决从入门到团队协作中90%的Gitee日常操作问题无论是个人项目备份、开源贡献还是小团队的代码管理都能直接上手。2. Gitee核心功能全景与入门配置2.1 账号注册、仓库创建与基础概念扫盲第一步永远是访问Gitee官网并注册账号这个过程和注册任何一个网站没区别。注册成功后你会进入个人主页。这里你需要先理解几个核心概念这能帮你后续操作时不迷糊仓库Repository你的项目在Gitee上的“家”里面存放着代码、文档等所有项目文件及其历史记录。它分为“公开”所有人可见可克隆和“私有”仅你或指定成员可见两种。克隆Clone将Gitee上远程仓库的完整副本包括所有历史记录下载到你的本地电脑。这是你开始工作的起点。提交Commit将你本地修改过的文件打包成一个有描述的历史记录点保存到本地仓库中。你可以把一次提交想象成游戏的一个存档点。推送Push将你本地仓库中的提交记录上传到Gitee上的远程仓库。这样别人才能看到你的改动。拉取Pull/Fetch将Gitee远程仓库上别人推送的新提交下载到你的本地仓库以同步最新代码。创建你的第一个仓库很简单点击网站右上角的“”号选择“新建仓库”。你需要填写仓库名称、简介选择公开/私有以及是否初始化README.md、.gitignore用于忽略不需要版本控制的文件如日志、编译产物和开源许可证。对于新手我的建议是务必勾选“使用README.md初始化仓库”和“选择.gitignore模板”根据你的项目语言选择如Java、Python。这能帮你建立一个结构清晰、避免提交无用文件的起点。开源许可证则根据你是否希望别人使用、修改你的代码来选择GPL、MIT、Apache是常见选项。2.2 本地Git环境搭建与SSH密钥配置要在本地操作Gitee仓库你需要在电脑上安装Git。去Git官网下载对应你操作系统Windows、macOS、Linux的安装包安装过程基本一路“Next”即可。安装完成后打开终端Windows上是Git Bash或CMD/PowerShellmacOS/Linux是Terminal通过git --version命令验证是否安装成功。接下来是关键一步也是第一个容易卡住的地方配置SSH密钥。为什么需要它因为用它比用账号密码更安全、更方便无需每次输入密码。操作步骤如下生成密钥对在终端输入ssh-keygen -t rsa -C 你的邮箱example.com。连续按几次回车接受默认的文件保存路径和不设置密码为求简便初学者可不设密码。完成后会在你的用户目录下的.ssh文件夹里生成两个文件id_rsa私钥绝不能泄露和id_rsa.pub公钥需要上传到Gitee。添加公钥到Gitee用文本编辑器打开id_rsa.pub文件复制全部内容。登录Gitee点击头像 - 设置 - SSH公钥。标题可以任意填如“My Laptop”将复制的公钥内容粘贴到“公钥”框中点击“确定”。验证连接回到终端输入ssh -T gitgitee.com。如果看到 “Hi XXX! Youve successfully authenticated...” 的欢迎信息说明配置成功。注意如果你之前生成过SSH密钥且用于其他平台如GitHubGitee可能会连接失败。这是因为默认会尝试使用id_rsa这个密钥。你需要将Gitee的公钥也添加到那个已有的密钥对应的授权列表中或者为Gitee单独生成一对密钥并通过ssh config文件进行管理。这是第一个实操中常见的“坑”。2.3 仓库克隆与本地关联的两种方式拿到Gitee仓库地址后你有两种方式在本地开始工作方式一克隆现有仓库最常用。在Gitee仓库页面上点击绿色的“克隆/下载”按钮选择SSH或HTTPS地址配置了SSH后推荐用SSH。然后在终端进入你希望存放项目的本地目录执行git clone gitgitee.com:yourname/repo-name.git。这会在当前目录下创建一个与仓库同名的文件夹里面包含了所有代码和历史。方式二本地初始化后关联远程仓库。如果你先在本地创建了一个项目文件夹并想把它推送到Gitee上新建的空仓库。首先在项目文件夹内打开终端执行git init初始化本地仓库。然后添加远程仓库地址git remote add origin gitgitee.com:yourname/repo-name.git。这里的origin是一个别名代表你关联的远程仓库地址。3. Git核心工作流与高频命令详解理解了基本概念并配置好环境后我们来深入最核心的部分日常开发中你一定会用到的Git命令和工作流。我把它们总结为一条主线“拉取 - 修改 - 暂存 - 提交 - 推送”并穿插分支管理。3.1 单人本地开发提交与推送假设你刚克隆了一个仓库准备开始修改代码。查看状态在做出任何操作前养成习惯先运行git status。这个命令会告诉你当前所在的分支哪些文件被修改了哪些是新文件还未被跟踪哪些修改已经暂存等待提交。它是你的“战场态势感知”工具。添加更改到暂存区Git有一个“暂存区”Stage/Index的概念你可以把它理解为提交前的准备区。使用git add file来添加特定文件或者使用git add .来添加所有当前目录下的更改慎用避免提交无关文件。例如你修改了main.py和readme.md可以分别添加也可以一起添加。提交更改将暂存区的内容打包成一个永久的快照使用git commit -m “这里写提交说明”。提交说明至关重要好的说明应该简洁清晰地描述本次提交的目的例如“修复用户登录时密码验证失败的bug”而不是“更新了代码”。清晰的提交历史是项目可维护性的基石。推送到远程仓库本地提交只保存在你的电脑上。要让Gitee上的仓库同步需要执行git push origin master如果你在主分支master或main上。这条命令将你本地的提交推送到远程仓库origin的master分支。实操心得在git commit之前我强烈推荐使用git diff命令。它会高亮显示你本次修改的具体内容行级别的增删让你在提交前最后确认一遍避免提交了调试用的print语句或者错误的代码。对于已暂存的文件可以用git diff --staged查看。3.2 分支管理功能开发与合并的基石分支是Git的杀手锏功能它让你能在一条独立的开发线上工作而不影响主线通常是master分支。团队协作和功能开发离不开它。创建并切换分支git checkout -b feature-new-login。这条命令合并了两步创建名为feature-new-login的新分支并立即切换到这个分支上。现在你的所有修改都只在这个分支上进行。查看分支git branch列出所有本地分支当前分支前会有一个*号。git branch -a可以查看包括远程分支在内的所有分支。切换分支git checkout master切换回主分支。合并分支当feature-new-login分支上的功能开发并测试完毕后你需要将其合并到主分支。首先切换回mastergit checkout master。然后执行合并git merge feature-new-login。如果合并过程没有冲突Git会自动创建一个新的“合并提交”。删除分支功能合并后可以删除这个特性分支以保持整洁git branch -d feature-new-login。3.3 团队协作核心拉取、冲突与合并请求当多人协作时你的同事也会向远程仓库推送代码。在你推送之前必须先将他们的改动拉取下来合并到你的本地工作副本中避免覆盖别人的工作。拉取远程更新最安全的做法是使用git pull origin master。这个命令实际上是git fetch获取远程更新和git merge合并到当前分支两个命令的合并。执行后远程master分支的新提交就会合并到你本地的master分支。处理合并冲突这是协作中最常见也最让人头疼的问题。当你和同事修改了同一文件的同一区域时Git无法自动决定保留谁的修改就会产生冲突。执行git pull后如果终端提示CONFLICT你需要手动解决。用编辑器打开冲突文件你会看到类似 HEAD commit-id的标记。它们分别包裹了你本地的修改和远程拉取的修改。你需要与同事沟通决定保留哪一部分或者进行整合然后删除这些标记符号。解决完所有冲突文件后执行git add .标记冲突已解决再执行git commit来完成这次合并。使用合并请求Pull Request进行代码审查在团队规范或开源项目中直接向主分支推送代码通常是不被允许的。更标准的流程是将你的特性分支推送到远程git push origin feature-new-login。在Gitee仓库页面你会看到提示可以创建“合并请求”PR。点击创建选择将你的feature-new-login分支合并到master分支。填写清晰的标题和描述说明这个PR的目的、改了些什么、如何测试。可以邀请团队成员进行评审。评审者可以在线查看代码差异、提出评论。经过讨论和可能的修改后由项目维护者点击“合并”按钮完成集成。这个过程极大地保证了代码质量。4. 进阶技巧与Gitee特色功能实战4.1 .gitignore的精准配置与清理历史.gitignore文件用得好能让你仓库保持清爽。它的规则很简单每行一个模式。*是通配符/表示目录!表示例外。常见模式# 忽略所有.class编译文件 *.class # 忽略某个特定文件 /config/local.properties # 忽略某个目录下的所有文件 /target/ /node_modules/ # 但不要忽略target目录下的important.jar !/target/important.jar问题在于.gitignore只对未跟踪的文件生效。如果你之前不小心把node_modules这样的目录提交了上去现在即使加了规则Git依然会跟踪它。这时需要清理历史记录git rm -r --cached node_modules--cached表示只从索引中删除保留本地文件然后git add .和git commit -m “清理node_modules目录”。这是一个危险操作如果团队其他成员已经拉取了包含这些文件的仓库会引发混乱因此最好在项目初期就配置好.gitignore。4.2 Gitee Pages零成本部署静态网站这是Gitee一个非常实用的免费功能。你可以将仓库里的HTML、CSS、JavaScript等静态文件自动部署成一个可公开访问的网站常用于项目文档、博客、个人主页等。在仓库中进入“服务” - “Gitee Pages”。选择部署分支通常是master或gh-pages和部署目录根目录/或某个子目录如/docs。点击“启动”。首次部署可能需要几分钟。成功后你会获得一个用户名.gitee.io/仓库名的访问地址。注意Gitee Pages 需要仓库是公开的。并且与GitHub Pages不同Gitee Pages在每次你推送新代码后不会自动更新你需要手动点击“更新”按钮。这是为了节省服务器资源记得每次推送后去点一下。4.3 使用Gitee的WebIDE与文件管理对于临时的小修改或查看代码你甚至可以不打开本地IDE。Gitee提供了在线WebIDE在仓库页点击“WebIDE”按钮和强大的文件管理功能。在线编辑在仓库文件浏览页面点击任何一个文件再点击“编辑”图标就可以直接在网页上修改并提交。非常适合快速修复文档中的错别字。直接上传在仓库根目录或任何文件夹点击“上传文件”按钮可以批量将本地文件拖拽上传并直接填写提交信息。这对于初始化项目或添加非代码资源如图片非常方便。下载单个文件在文件浏览页面找到所需文件点击“原始数据”或“下载”按钮即可。无需克隆整个仓库。4.4 子模块Submodule与镜像同步子模块当你的项目需要依赖另一个独立的Git仓库比如一个公共的组件库时可以使用git submodule。它允许你将另一个仓库作为你项目的一个子目录来管理同时保持其独立的提交历史。操作略复杂涉及git submodule add和git submodule update --init --recursive适合有明确模块化需求的进阶项目。仓库镜像如果你在GitHub上有一个项目希望自动同步到Gitee做备份或为国内用户加速访问可以使用Gitee的“仓库镜像”功能。在Gitee上新建仓库时选择“导入已有仓库”填入GitHub仓库的HTTPS地址即可。更高级的可以设置定时同步。5. 常见问题排查与高效操作清单5.1 高频错误与解决方案速查表问题现象可能原因解决方案git push失败提示Permission denied (publickey).SSH密钥未配置或配置错误。1. 执行ssh -T gitgitee.com测试连接。2. 确认Gitee上添加的公钥与本地id_rsa.pub内容完全一致。3. 检查是否使用了正确的SSH URLgitgitee.com:...。git pull失败提示fatal: refusing to merge unrelated histories本地仓库和远程仓库的初始提交历史不相关常见于先git init再git remote add的情况。在pull命令后加上--allow-unrelated-histories参数git pull origin master --allow-unrelated-histories。使用前请确认这确实是两个独立仓库需要强制合并。执行git add .后不想提交某个文件了。误将不需要的文件加入了暂存区。使用git reset HEAD file将特定文件从暂存区撤出但保留工作区的修改。或者用git reset HEAD清空整个暂存区。提交信息写错了想修改最后一次提交。提交后发现有错别字或漏文件。git commit --amend。这会打开编辑器让你修改提交信息如果只是补文件可以先git add文件再执行此命令。注意如果已经推送push到远程强制修改历史 (git push -f) 会破坏协作需极其谨慎。想回到某个旧版本的状态丢弃所有后来的修改。代码改乱了想彻底回退。1. 用git log --oneline找到想回退到的那个提交的ID前7位即可。2. 执行git reset --hard commit_id。警告这会丢弃所有工作区和暂存区的更改不可恢复请先确认已备份重要改动。5.2 提升效率的Alias命令别名配置每天输入几十遍git status、git checkout很繁琐。你可以在Git的全局配置中设置别名将长命令缩短。 打开终端执行如下命令git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.pl pull git config --global alias.ps push配置后你就可以用git st代替git status用git co master代替git checkout master效率大幅提升。你还可以定义更复杂的别名比如git config --global alias.lg “log --oneline --graph --all”用一个git lg就能看到漂亮的分支图。5.3 图形化工具作为辅助虽然命令行是根本但图形化工具GUI在查看历史、解决冲突、暂存部分文件hunk时非常直观。VSCode内置了优秀的Git GUISourceTree、GitKraken也是流行的选择。我的工作流是日常操作add, commit, push, pull用命令行复杂历史查看、交互式暂存和冲突解决用GUI。两者结合事半功倍。特别是VSCode的源代码管理面板对于可视化暂存更改、查看行级差异体验非常好。掌握以上内容你不仅能够流畅地使用Gitee进行个人和团队项目开发更能理解Git工作流背后的设计哲学。工具的价值在于熟练运用现在就去创建一个测试仓库把上面的命令从头到尾敲一遍遇到问题就回来查表这才是最快的学习路径。编程本身是实践代码管理亦然。 Gitee与Git核心使用指南：从入门到团队协作实战
1. 项目概述为什么你需要一份“终极”Gitee指南如果你刚开始接触代码托管或者从GitHub转向国内平台Gitee码云大概率是你绕不开的一个名字。作为国内领先的代码托管与协作平台它提供了与GitHub类似的核心功能——Git仓库管理、Issue跟踪、Pull Request在Gitee里叫“合并请求”、Wiki文档等但最大的优势在于访问速度快、中文界面友好并且集成了CI/CDGeeK、Pages静态站点等实用服务。网上关于Gitee的教程确实不少但要么是零散的“如何注册”要么是深奥的“Git原理详解”新手看完常常是“眼睛会了手不会”。我花了些时间结合自己从零开始到团队协作的完整经历把Gitee的核心使用链路、高频命令、以及那些官方文档里不会写的“坑”和“技巧”系统地梳理了一遍。这篇内容的目标很明确让你手边有这一份指南就能解决从入门到团队协作中90%的Gitee日常操作问题无论是个人项目备份、开源贡献还是小团队的代码管理都能直接上手。2. Gitee核心功能全景与入门配置2.1 账号注册、仓库创建与基础概念扫盲第一步永远是访问Gitee官网并注册账号这个过程和注册任何一个网站没区别。注册成功后你会进入个人主页。这里你需要先理解几个核心概念这能帮你后续操作时不迷糊仓库Repository你的项目在Gitee上的“家”里面存放着代码、文档等所有项目文件及其历史记录。它分为“公开”所有人可见可克隆和“私有”仅你或指定成员可见两种。克隆Clone将Gitee上远程仓库的完整副本包括所有历史记录下载到你的本地电脑。这是你开始工作的起点。提交Commit将你本地修改过的文件打包成一个有描述的历史记录点保存到本地仓库中。你可以把一次提交想象成游戏的一个存档点。推送Push将你本地仓库中的提交记录上传到Gitee上的远程仓库。这样别人才能看到你的改动。拉取Pull/Fetch将Gitee远程仓库上别人推送的新提交下载到你的本地仓库以同步最新代码。创建你的第一个仓库很简单点击网站右上角的“”号选择“新建仓库”。你需要填写仓库名称、简介选择公开/私有以及是否初始化README.md、.gitignore用于忽略不需要版本控制的文件如日志、编译产物和开源许可证。对于新手我的建议是务必勾选“使用README.md初始化仓库”和“选择.gitignore模板”根据你的项目语言选择如Java、Python。这能帮你建立一个结构清晰、避免提交无用文件的起点。开源许可证则根据你是否希望别人使用、修改你的代码来选择GPL、MIT、Apache是常见选项。2.2 本地Git环境搭建与SSH密钥配置要在本地操作Gitee仓库你需要在电脑上安装Git。去Git官网下载对应你操作系统Windows、macOS、Linux的安装包安装过程基本一路“Next”即可。安装完成后打开终端Windows上是Git Bash或CMD/PowerShellmacOS/Linux是Terminal通过git --version命令验证是否安装成功。接下来是关键一步也是第一个容易卡住的地方配置SSH密钥。为什么需要它因为用它比用账号密码更安全、更方便无需每次输入密码。操作步骤如下生成密钥对在终端输入ssh-keygen -t rsa -C 你的邮箱example.com。连续按几次回车接受默认的文件保存路径和不设置密码为求简便初学者可不设密码。完成后会在你的用户目录下的.ssh文件夹里生成两个文件id_rsa私钥绝不能泄露和id_rsa.pub公钥需要上传到Gitee。添加公钥到Gitee用文本编辑器打开id_rsa.pub文件复制全部内容。登录Gitee点击头像 - 设置 - SSH公钥。标题可以任意填如“My Laptop”将复制的公钥内容粘贴到“公钥”框中点击“确定”。验证连接回到终端输入ssh -T gitgitee.com。如果看到 “Hi XXX! Youve successfully authenticated...” 的欢迎信息说明配置成功。注意如果你之前生成过SSH密钥且用于其他平台如GitHubGitee可能会连接失败。这是因为默认会尝试使用id_rsa这个密钥。你需要将Gitee的公钥也添加到那个已有的密钥对应的授权列表中或者为Gitee单独生成一对密钥并通过ssh config文件进行管理。这是第一个实操中常见的“坑”。2.3 仓库克隆与本地关联的两种方式拿到Gitee仓库地址后你有两种方式在本地开始工作方式一克隆现有仓库最常用。在Gitee仓库页面上点击绿色的“克隆/下载”按钮选择SSH或HTTPS地址配置了SSH后推荐用SSH。然后在终端进入你希望存放项目的本地目录执行git clone gitgitee.com:yourname/repo-name.git。这会在当前目录下创建一个与仓库同名的文件夹里面包含了所有代码和历史。方式二本地初始化后关联远程仓库。如果你先在本地创建了一个项目文件夹并想把它推送到Gitee上新建的空仓库。首先在项目文件夹内打开终端执行git init初始化本地仓库。然后添加远程仓库地址git remote add origin gitgitee.com:yourname/repo-name.git。这里的origin是一个别名代表你关联的远程仓库地址。3. Git核心工作流与高频命令详解理解了基本概念并配置好环境后我们来深入最核心的部分日常开发中你一定会用到的Git命令和工作流。我把它们总结为一条主线“拉取 - 修改 - 暂存 - 提交 - 推送”并穿插分支管理。3.1 单人本地开发提交与推送假设你刚克隆了一个仓库准备开始修改代码。查看状态在做出任何操作前养成习惯先运行git status。这个命令会告诉你当前所在的分支哪些文件被修改了哪些是新文件还未被跟踪哪些修改已经暂存等待提交。它是你的“战场态势感知”工具。添加更改到暂存区Git有一个“暂存区”Stage/Index的概念你可以把它理解为提交前的准备区。使用git add file来添加特定文件或者使用git add .来添加所有当前目录下的更改慎用避免提交无关文件。例如你修改了main.py和readme.md可以分别添加也可以一起添加。提交更改将暂存区的内容打包成一个永久的快照使用git commit -m “这里写提交说明”。提交说明至关重要好的说明应该简洁清晰地描述本次提交的目的例如“修复用户登录时密码验证失败的bug”而不是“更新了代码”。清晰的提交历史是项目可维护性的基石。推送到远程仓库本地提交只保存在你的电脑上。要让Gitee上的仓库同步需要执行git push origin master如果你在主分支master或main上。这条命令将你本地的提交推送到远程仓库origin的master分支。实操心得在git commit之前我强烈推荐使用git diff命令。它会高亮显示你本次修改的具体内容行级别的增删让你在提交前最后确认一遍避免提交了调试用的print语句或者错误的代码。对于已暂存的文件可以用git diff --staged查看。3.2 分支管理功能开发与合并的基石分支是Git的杀手锏功能它让你能在一条独立的开发线上工作而不影响主线通常是master分支。团队协作和功能开发离不开它。创建并切换分支git checkout -b feature-new-login。这条命令合并了两步创建名为feature-new-login的新分支并立即切换到这个分支上。现在你的所有修改都只在这个分支上进行。查看分支git branch列出所有本地分支当前分支前会有一个*号。git branch -a可以查看包括远程分支在内的所有分支。切换分支git checkout master切换回主分支。合并分支当feature-new-login分支上的功能开发并测试完毕后你需要将其合并到主分支。首先切换回mastergit checkout master。然后执行合并git merge feature-new-login。如果合并过程没有冲突Git会自动创建一个新的“合并提交”。删除分支功能合并后可以删除这个特性分支以保持整洁git branch -d feature-new-login。3.3 团队协作核心拉取、冲突与合并请求当多人协作时你的同事也会向远程仓库推送代码。在你推送之前必须先将他们的改动拉取下来合并到你的本地工作副本中避免覆盖别人的工作。拉取远程更新最安全的做法是使用git pull origin master。这个命令实际上是git fetch获取远程更新和git merge合并到当前分支两个命令的合并。执行后远程master分支的新提交就会合并到你本地的master分支。处理合并冲突这是协作中最常见也最让人头疼的问题。当你和同事修改了同一文件的同一区域时Git无法自动决定保留谁的修改就会产生冲突。执行git pull后如果终端提示CONFLICT你需要手动解决。用编辑器打开冲突文件你会看到类似 HEAD commit-id的标记。它们分别包裹了你本地的修改和远程拉取的修改。你需要与同事沟通决定保留哪一部分或者进行整合然后删除这些标记符号。解决完所有冲突文件后执行git add .标记冲突已解决再执行git commit来完成这次合并。使用合并请求Pull Request进行代码审查在团队规范或开源项目中直接向主分支推送代码通常是不被允许的。更标准的流程是将你的特性分支推送到远程git push origin feature-new-login。在Gitee仓库页面你会看到提示可以创建“合并请求”PR。点击创建选择将你的feature-new-login分支合并到master分支。填写清晰的标题和描述说明这个PR的目的、改了些什么、如何测试。可以邀请团队成员进行评审。评审者可以在线查看代码差异、提出评论。经过讨论和可能的修改后由项目维护者点击“合并”按钮完成集成。这个过程极大地保证了代码质量。4. 进阶技巧与Gitee特色功能实战4.1 .gitignore的精准配置与清理历史.gitignore文件用得好能让你仓库保持清爽。它的规则很简单每行一个模式。*是通配符/表示目录!表示例外。常见模式# 忽略所有.class编译文件 *.class # 忽略某个特定文件 /config/local.properties # 忽略某个目录下的所有文件 /target/ /node_modules/ # 但不要忽略target目录下的important.jar !/target/important.jar问题在于.gitignore只对未跟踪的文件生效。如果你之前不小心把node_modules这样的目录提交了上去现在即使加了规则Git依然会跟踪它。这时需要清理历史记录git rm -r --cached node_modules--cached表示只从索引中删除保留本地文件然后git add .和git commit -m “清理node_modules目录”。这是一个危险操作如果团队其他成员已经拉取了包含这些文件的仓库会引发混乱因此最好在项目初期就配置好.gitignore。4.2 Gitee Pages零成本部署静态网站这是Gitee一个非常实用的免费功能。你可以将仓库里的HTML、CSS、JavaScript等静态文件自动部署成一个可公开访问的网站常用于项目文档、博客、个人主页等。在仓库中进入“服务” - “Gitee Pages”。选择部署分支通常是master或gh-pages和部署目录根目录/或某个子目录如/docs。点击“启动”。首次部署可能需要几分钟。成功后你会获得一个用户名.gitee.io/仓库名的访问地址。注意Gitee Pages 需要仓库是公开的。并且与GitHub Pages不同Gitee Pages在每次你推送新代码后不会自动更新你需要手动点击“更新”按钮。这是为了节省服务器资源记得每次推送后去点一下。4.3 使用Gitee的WebIDE与文件管理对于临时的小修改或查看代码你甚至可以不打开本地IDE。Gitee提供了在线WebIDE在仓库页点击“WebIDE”按钮和强大的文件管理功能。在线编辑在仓库文件浏览页面点击任何一个文件再点击“编辑”图标就可以直接在网页上修改并提交。非常适合快速修复文档中的错别字。直接上传在仓库根目录或任何文件夹点击“上传文件”按钮可以批量将本地文件拖拽上传并直接填写提交信息。这对于初始化项目或添加非代码资源如图片非常方便。下载单个文件在文件浏览页面找到所需文件点击“原始数据”或“下载”按钮即可。无需克隆整个仓库。4.4 子模块Submodule与镜像同步子模块当你的项目需要依赖另一个独立的Git仓库比如一个公共的组件库时可以使用git submodule。它允许你将另一个仓库作为你项目的一个子目录来管理同时保持其独立的提交历史。操作略复杂涉及git submodule add和git submodule update --init --recursive适合有明确模块化需求的进阶项目。仓库镜像如果你在GitHub上有一个项目希望自动同步到Gitee做备份或为国内用户加速访问可以使用Gitee的“仓库镜像”功能。在Gitee上新建仓库时选择“导入已有仓库”填入GitHub仓库的HTTPS地址即可。更高级的可以设置定时同步。5. 常见问题排查与高效操作清单5.1 高频错误与解决方案速查表问题现象可能原因解决方案git push失败提示Permission denied (publickey).SSH密钥未配置或配置错误。1. 执行ssh -T gitgitee.com测试连接。2. 确认Gitee上添加的公钥与本地id_rsa.pub内容完全一致。3. 检查是否使用了正确的SSH URLgitgitee.com:...。git pull失败提示fatal: refusing to merge unrelated histories本地仓库和远程仓库的初始提交历史不相关常见于先git init再git remote add的情况。在pull命令后加上--allow-unrelated-histories参数git pull origin master --allow-unrelated-histories。使用前请确认这确实是两个独立仓库需要强制合并。执行git add .后不想提交某个文件了。误将不需要的文件加入了暂存区。使用git reset HEAD file将特定文件从暂存区撤出但保留工作区的修改。或者用git reset HEAD清空整个暂存区。提交信息写错了想修改最后一次提交。提交后发现有错别字或漏文件。git commit --amend。这会打开编辑器让你修改提交信息如果只是补文件可以先git add文件再执行此命令。注意如果已经推送push到远程强制修改历史 (git push -f) 会破坏协作需极其谨慎。想回到某个旧版本的状态丢弃所有后来的修改。代码改乱了想彻底回退。1. 用git log --oneline找到想回退到的那个提交的ID前7位即可。2. 执行git reset --hard commit_id。警告这会丢弃所有工作区和暂存区的更改不可恢复请先确认已备份重要改动。5.2 提升效率的Alias命令别名配置每天输入几十遍git status、git checkout很繁琐。你可以在Git的全局配置中设置别名将长命令缩短。 打开终端执行如下命令git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.pl pull git config --global alias.ps push配置后你就可以用git st代替git status用git co master代替git checkout master效率大幅提升。你还可以定义更复杂的别名比如git config --global alias.lg “log --oneline --graph --all”用一个git lg就能看到漂亮的分支图。5.3 图形化工具作为辅助虽然命令行是根本但图形化工具GUI在查看历史、解决冲突、暂存部分文件hunk时非常直观。VSCode内置了优秀的Git GUISourceTree、GitKraken也是流行的选择。我的工作流是日常操作add, commit, push, pull用命令行复杂历史查看、交互式暂存和冲突解决用GUI。两者结合事半功倍。特别是VSCode的源代码管理面板对于可视化暂存更改、查看行级差异体验非常好。掌握以上内容你不仅能够流畅地使用Gitee进行个人和团队项目开发更能理解Git工作流背后的设计哲学。工具的价值在于熟练运用现在就去创建一个测试仓库把上面的命令从头到尾敲一遍遇到问题就回来查表这才是最快的学习路径。编程本身是实践代码管理亦然。