很多人第一次接触 Gitee 的心情和我当年一样看着“仓库”“分支”“SSH 密钥”这些词每个字都认识放在一起就完全看不懂。但这个东西又绕不开——不管是交作业、传项目、还是和老铁们一起协作Gitee 几乎是国内开发者绕不过去的一站。我用了大概两年从最开始只会点网页上的“新建仓库”到后面天天用命令行 push 代码中间踩了不少坑也总结了一套最适合零基础入门的路径。这篇教程不搞理论轰炸直接按照“注册 → 配置 → 上传 → 拉取 → 部署 → 排错”的顺序带你一步步把 Gitee 用起来。全程只说人话所有命令都给完整版你照着敲就行。1. 注册与新建仓库先把“家”安好1.1 账号注册的完整路径与安全设置注册这一步看起来没什么好说的但实际上有不少细节会影响后面的使用体验。打开 Gitee 官网右上角“注册”按钮进去支持手机号注册也支持微信扫码。我的建议是优先用手机号注册因为后面涉及到找回密码、二次验证、甚至 Pages 服务的一些验证操作手机号是最直接的身份凭证。注册过程中有一个容易被忽略的选项用户名。Gitee 的用户名不是随意取的它会被用在你的个人主页地址里格式是https://gitee.com/你的用户名。这个地址就是你未来分享项目时的门牌号取一个短一点、好记、和你的项目定位相关的用户名会省很多事。我见过有人用了一长串乱码当用户名每次给别人发仓库链接都特别尴尬。密码设置建议至少 10 位以上包含大小写字母和数字。因为 Gitee 在某些操作比如创建仓库、删除仓库、修改 SSH 密钥时会要求验证密码太简单的密码容易在验证环节出问题。注册完成后直接进入个人首页此时你的私人仓库数量是有一定限制的但一般个人学习使用完全够不需要急着开通付费服务。手机号注册后强烈建议立刻去“设置 → 安全设置”里把双重验证打开。它的原理是登录时除了密码还要额外收一条验证码。这样就算有人在某个角落拿到你的密码也进不了你的仓库。我身边就有同事因为没开双重验证账号被盗后仓库被清空的情况这个坑你没必要亲身体验一次。1.2 新建仓库时我要怎么选参数登录进去以后真正的第一步是“新建仓库”。点击右上角“”号或者直接进入仓库页点“新建”就会看到一张参数表单。这里我逐个说清楚每个字段的作用因为这些选项一旦选错后面改动起来会麻烦不少。第一项“仓库名称”最好用英文小写加短横线比如my-blog、spring-demo。为什么会强调这个因为仓库名称会出现在你的项目地址里中文或者大写字母虽然能用但在某些终端工具、脚本命令里会出现编码问题粘到命令行里很别扭。斜杠后面的名字就是仓库名路径前缀是你刚才的用户名。第二项“路径”默认会和仓库名一样一般不用动。然后是“开源许可证”的选择这个选项很多人会顺手跳过但实际上它决定了别人能不能用你的代码、怎么用。常见的选项有 MIT、Apache-2.0、GPL-3.0 这几种。简单说如果你希望别人随便拿去用甚至商用选 MIT如果你希望别人用了你的代码也必须开源选 GPL-3.0如果你主要是为了个人学习记录不在乎别人怎么用也可以先不选后续再补。热词里专门有人搜“gitee开源许可证选什么”可见这个坑踩的人不少。我的建议是默认选 MIT对新手最友好一句话说清楚“你可以随便用但出了问题别找我”。“仓库类型”有私有和公开两种。私有仓库只有你和被你主动加进来的协作者能看到公开仓库所有人都能看到。学习阶段我建议直接选“私有”因为很多代码写完可能自己看着都脸红没必要直接公开。另外私有仓库在 Gitee 上是有数量限制的但免费额度对日常学习完全够用。后续想公开在仓库设置里一键切换就行不受任何限制。最后是这个“初始化仓库”区域新手建议把“使用 Readme 文件初始化这个仓库”勾上这样仓库创建成功后会自动生成一个 README.md 文件里面会写上项目的基础说明。同时建议配上对应的 .gitignore 模板后面细说。“选择分支模型”一般用默认的“单分支模型”就好也就是只会生成一个 master 分支简洁直接等你了解了分支合并再说其他模型的事。1.3 README、许可证和 .gitignore 到底干嘛的创建完成后你的仓库里有三个基础文件值得理解README.md、LICENSE 和 .gitignore如果选择了模板的话。README.md 是仓库的门面别人进到你的仓库第一眼看到的就是它。Markdown 格式说白了就是一种轻量级的排版语法#是一级标题##是二级标题用-可以列要点。你可以在这里写这个项目是干嘛的、怎么运行、需要什么环境。这玩意不光是给别人看的三个月后的你自己也会是“别人”到时候你翻回来看这个文档会感激当初写清楚了。LICENSE 文件存的是你在 1.2 里选的那个许可证全文。它相当于一份法律层面的使用授权声明。很多人误以为代码放在代码托管平台上就默认允许别人随意下载使用实际上只要没声明许可证代码的版权都归你本人所有别人下载了也没有合法使用权限。所以如果你打算开源这一步不能省。.gitignore 文件是给 Git 看的“黑名单”凡是写在这里面的文件或目录Git 会直接忽略不会提交到仓库。对新手来说最常见的就是node_modules/、.idea/、target/、__pycache__/这类目录。这些文件要么是依赖包几万个文件要么是 IDE 的个人配置传到仓库里没有任何意义反而会污染项目。如果你在创建仓库时没选 .gitignore 模板后面可以在项目根目录手动建一个.gitignore文件直接复制网上的模板改一改就行。2. 把本机“焊”到 GiteeGit 安装与密钥配置2.1 安装 Git三个平台的差异一次说清接下来是从本质上做不了假的步骤装 Git。Git 是 Gitee 背后的核心技术Gitee 只是 Git 的一个远程托管服务。你本地的代码要先被 Git 管理起来才能推送到 Gitee 上。Windows 用户直接去 Git 官网下载安装包一路默认下一步就行。需要注意的一点是安装过程中会有一个“调整 PATH”的选项务必确认选的是“Git from the command line and also from 3rd-party software”这样后面 IDEA 或者 VS Code 才能正常调用 Git。macOS 用户可以在终端里输入git --version如果有提示说明系统自带如果没有可以用xcode-select --install或者直接下载安装包。Linux 用户根据发行版不同一般是sudo apt install git或者sudo yum install git。装完以后在终端里输入git --version能打印出版本号就说明装好了。这一步验证很重要很多人装完以为好了结果一打开命令行还是提示命令找不到通常是 PATH 没配置对。2.2 配置身份信息提交记录里的“签名”Git 的提交记录里会记录作者是谁这个“签名”就是你配置的昵称和邮箱。这里必须强调邮箱不一定非要用注册 Gitee 时用的那个邮箱。因为 Git 提交记录里的邮箱只是作为文字显示在 commit 信息里提交记录归属到你的 Gitee 账号则靠的是 SSH 密钥或者账号密码。配置命令很简单打开终端执行git config --global user.name 你的昵称 git config --global user.email 你的邮箱--global参数表示全局生效也就是这台电脑上的所有 Git 仓库都会用这个身份。如果你只在某个特定项目里用不同身份可以在项目目录下不加--global重新执行一次覆盖全局配置。配置完之后可以用下面的命令查看当前全局配置git config --global --list看到两行user.name和user.email就说明配置成功。这个时候你的第一个 commit 就能正常记录了不然会报“Please tell me who you are”的错误也就是 Git 在问你“你到底是谁”。2.3 SSH 密钥生成与公钥配置含多平台共存现在到了很多人卡壳的地方SSH 密钥。先说人话解释一下这个机制。平时我们访问某个网站需要输入密码这个叫“账号密码认证”。SSH 密钥则是另一种认证方式它是一对钥匙一把锁在你自己电脑里私钥另一把挂在 Gitee 上公钥。你的电脑向 Gitee 请求时Gitee 用公钥验证你的身份成功就放行。比起每次操作都输入密码SSH 最大的优点是安全且免密。生成密钥的命令是ssh-keygen -t rsa -C 你的邮箱 -f ~/.ssh/gitee_id_rsa这条命令有几个参数需要解释一下-t rsa指定用 RSA 算法生成密钥-C是注释通常填邮箱但这只是一个标签也方便你自己辨认-f指定生成的文件名这里我故意用了gitee_id_rsa而不是默认的id_rsa原因是如果你还需要用 GitHub就避免两个平台的密钥相互覆盖——这个问题在热词里就有人专门搜可见踩的人不少。执行后会提示设置 passphrase密码短语这个可以留空直接回车表示不额外保护私钥。执行完成后在~/.ssh/目录下会生成gitee_id_rsa私钥和gitee_id_rsa.pub公钥两个文件。接下来要把公钥内容添加到 Gitee。用命令cat ~/.ssh/gitee_id_rsa.pub查看内容复制一整行通常以ssh-rsa开头一直到最后一段字符。然后打开 Gitee 的“设置 → SSH 公钥”把内容粘贴进去标题任意填比如“我的电脑”。到这里密钥配置就完成了一半。如果你只用 Gitee 一个平台可以把-f参数去掉直接生成默认的id_rsa密钥系统会自动识别。但如果你和我一样 Gitee 和 GitHub 都要用那就必须用上面的自定义文件名方案还要在~/.ssh/下创建一个config文件来区分两个平台的密钥# ~/.ssh/config Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/gitee_id_rsa Host github.com HostName github.com User git IdentityFile ~/.ssh/github_id_rsa这个文件的作用是告诉 SSH 客户端访问 gitee.com 时用gitee_id_rsa访问 github.com 时用github_id_rsa。这样就不会出现两边密钥串用的冲突了这也是热词中“本地全局设置了gitee和github两个库冲突”的标准解决方案。2.4 验证连通性ssh -T 到底在看什么密钥配好后需要验证一下能不能连通。终端里执行ssh -T gitgitee.com第一次执行时会提示确认主机的指纹信息输入yes回车即可。如果看到类似Hi 用户名! Youve successfully authenticated, but GITEE.COM does not provide shell access.这样的输出说明 SSH 密钥认证成功。这里穿插一个小提醒上面命令里的gitgitee.com中的git是 Gitee 服务器端的统一用户名不是你的 Gitee 用户名所有用户的 SSH 连接都是git大家统一走 git 这个入口。第一次看到 “does not provide shell access” 别慌这不是报错反而是成功提示意思是“认证已经通过但服务器不给你开 shell”。如果验证失败最常见的现象是Permission denied (publickey)。这类问题很大比例是因为私钥文件的权限设置不对或者config文件里的IdentityFile路径写错。SSH 对私钥文件的权限非常严格Windows 下用icacls或者直接在资源管理器里设置Linux/macOS 则必须保证私钥文件权限是 600也就是只有当前用户能读写可以用chmod 600 ~/.ssh/gitee_id_rsa这个命令必须执行权限过大 SSH 会直接拒绝使用该密钥。3. 日常开发三循环提交、推送、拉取与分支3.1 第一次完整上传代码init → add → commit → push现在进入核心实操环节。首先明确一个前置条件你已经有一个本地项目文件夹并且目录里已经有需要在 Gitee 仓库里存放的代码。如果项目还不存在可以在终端里mkdir my-project cd my-project进入项目目录后第一步是把这个目录变成 Git 仓库执行git init这一步会在当前目录下生成一个隐藏的.git文件夹它就是 Git 的灵魂。这个文件夹记录了你项目所有的历史版本、分支信息、提交记录以后每次提交都是在这个数据库里追加内容。接着把你想要传上去的文件加入暂存区。暂存区可以理解为“待拍摄的候场区”你先挑选一批文件告诉 Git “这些我要传”然后 Git 给它们拍一张快照这个快照就是一次提交。执行git add .这里的.代表当前目录所有未被忽略的文件。如果你想单独添加某个文件可以写git add 文件名。这时候你可以先执行git status看看有哪些文件被加进去了这会列出绿色显示的文件就是待提交清单。下一步是创建提交记录git commit -m 第一次提交初始化项目-m后面是提交说明这是给别人以及未来的自己看的日志说明这次提交做了什么。提交说明建议简洁但有信息量比如“修复登录页样式”“添加用户注册接口”就比“更新”规范得多。最后一步是推送。因为你是第一次推送到 Gitee需要给当前分支设置远程仓库地址git remote add origin gitgitee.com:你的用户名/仓库名.git git branch -M master git push -u origin master三条命令分工明确第一条把远程仓库地址绑定到本地仓库变量名origin是 Git 世界的约定俗成代表“远程主仓库”第二条把你的本地分支改名为master和 Gitee 默认分支名对齐第三条把 master 分支推送到远程-u参数会记住默认上游关系以后直接敲git push就能推送不用再带分支名。推送过程中如果弹出登录验证可能要输入 Gitee 的账号密码。如果你的仓库是用上面第 2 章的 SSH 方式配置的推送不会弹窗直接完成这也是为什么我强烈推荐 SSH。3.2 日常增量更新pull → add → commit → push当你的项目已经在 Gitee 上运行起来之后日常操作就固定成了一串“四步舞曲”。第一次是从空仓库拉代码以后就是循环这一套。先从“拉”开始。当你换了一台电脑或者别人在自己电脑上把代码推到了 Gitee你本地还是旧版本这时候需要拉取最新代码git pull执行完之后本地代码就和远程同步了。如果你是自己一个人维护项目没有别人参与那么每次写代码之前拉一次就能保证和远程一致。然后在你本地继续写代码。写完之后重复前面的操作git add . git commit -m 描述这次改动的内容 git push这套流程本质上就是暂存add→ 记录commit→ 上传push再加上一个写之前先同步pull。熟练之后整个过程的心理负担会降到很低这就是热词里“gitee拉取和上传项目”的全部秘密。这里有个很常见的新手问题git pull之后发现本地也有修改结果冲突了。冲突出现的原因是两个来源远程和本地改了同一个文件的同一行。解决方案是打开冲突文件找到类似下面这种标记 HEAD 你的本地代码 远程的代码 分支名手动把保留的内容留给中间部分删掉、、这些标记行然后重新 add、commit、push 就行。第一次遇到冲突会慌多来几次你会发现这其实就是一门“人工合并文字”的手艺活。3.3 分支操作创建、切换、合并与删除分支是 Git 最强大的功能之一但对零基础用户来说往往是最难理解的概念。我先给一个生活化的类比主分支 master 是正式发行的版本分支则是临时搭建的“试验场”。你在试验场里随便折腾代码不会影响到正式版本等试验场里的功能稳定了再把它合并回主分支来发行。创建分支的命令git branch feature-login这条命令会基于当前所在的提交点复制出一个新分支feature-login但你现在还在原来的分支上需要切换过去git checkout feature-login也可以一条命令实现创建加切换git checkout -b feature-login在分支上的操作和主分支完全一样照常 add、commit。等你觉得功能开发完了先切回主分支git checkout master git merge feature-loginmerge会把feature-login分支上的所有提交合并到当前分支。合并完后如果这个分支不再需要了可以删除git branch -d feature-login这里要提醒一句删除分支前一定要确认代码已经合并不然 Git 会拒绝删除并提示错误。分支和 Gitee 联动时推送远程分支需要多一个参数git push origin feature-login在 Gitee 网页上你可以到“分支管理”里看到这个远程分支也可以在 PRPull Request拉取请求功能里发起合并申请。Gitee 的 PR 功能适合团队协作因为代码合并前可以被审核一遍。零基础用户一开始用不到但先知道有这么个东西后面用起来就不陌生。3.4 用 IDEA 和 VS Code 图形化连接 Gitee命令行对新手来说像天书好在主流的 IDE 都提供了图形化操作其中最常用的是 IntelliJ IDEA。IDEA 内置了 Git 插件不需要额外配置。打开 IDEA 的“设置 → 版本控制 → Git”把第一个字段设置在 Git 可执行文件的路径Windows 下通常是C:\Program Files\Git\bin\git.exe点击“测试”按钮提示“Git 版本号”就说明连接成功。然后在“版本控制 → GitHub”里会看到 Gitee 的登录入口吗没有。Gitee 是国内的平台IDEA 并不直接内置 Gitee 插件需要先安装它提供的 Gitee 插件。打开 IDEA 的“文件 → 设置 → 插件”在市场搜索“Gitee”找到“Gitee”插件安装并重启 IDE。插件安装完成后在“版本控制”设置里的“Gitee”标签页用自己的 Gitee 账号登录。登录成功后顶部工具栏会多出一个“Gitee”入口选择“Share Project on Gitee”填上仓库名等信息就能直接把当前项目分享成 Gitee 仓库。之后的提交、推送、拉取都可以点击右侧更新按钮也就是下拉图标、对勾按钮完成对应命令行的 pull、commit。VS Code 则更轻量界面左侧的“源代码管理”面板就是 Git 的图形界面文件状态会用字母标注UUntracked未跟踪、MModified已修改、AAdded已暂存。在源代码管理面板里输入提交信息后按住 CtrlEnter 提交然后点“同步更改”按钮就完成推送。VS Code 同样需要先安装 Gitee 相关的扩展但只做 Git 操作本身并不需要额外插件因为它的 Git 面板原生支持远程仓库。4. 用 Gitee Pages 免费部署静态网站4.1 Pages 服务是什么、能干什么热词里专门有人搜“gitee pages”说明这块的需求量很大。简单说Gitee Pages 是 Gitee 提供的一项免费静态网页托管服务。你把写好的 HTML、CSS、JavaScript 文件推送到仓库Gitee 会自动帮你把仓库里的内容发布成网址别人通过https://用户名.gitee.io/仓库名/就能访问。学习阶段它最适合两个场景一个是部署个人主页也就是在一个仓库里放一个index.html就可以得到一个自己的个人主页另一个是部署工具页面比如在线简历、开源项目的演示页面、文档站点。为什么要用 Gitee Pages 而不是直接用很多免费的静态托管服务原因很简单你的代码本来就在 Gitee 上同步部署 Pages 不需要把代码从一个平台搬去别处也不用额外配置部署流程。对于零基础用户来说Pages 和代码仓库之间的联动是最无痛的方案。4.2 项目 Pages 的部署流程部署流程是这样的确认仓库里有一个index.html文件位置可以在根目录也可以在docs/目录下。如果你还没有这个文件先创建一个最基础的!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title我的第一个 Pages 页面/title /head body h1Hello Gitee Pages/h1 /body /html然后把这个文件提交并推送。提交推送的命令是git add . git commit -m 新增 Pages 页面 npm withdraw???注意我没有让你输入 npm 命令上面那个npm withdraw是手滑正确的操作就是上面的 Git 标准三连。继续git push推送完成后进入 Gitee 仓库主页找到“服务 → Gitee Pages”点击“部署”按钮。如果没有立即生效可以稍等几十秒页面通常会给你一个提示“部署成功”并给出一个网址。这个网址就是你网站的访问入口。Gitee Pages 的部署机制还支持自定义目录。如果你把站点文件放在docs/目录可以在部署页面选择“指定目录”为docs/如果放在根目录就选“根目录”。一个小细节Pages 服务的更新机制默认是手动更新的也就是说你每次改了代码 push 到仓库后需要在 Gitee Pages 页面点一次“更新”按钮网站内容才会刷新。热词里有人提到“gitee pages”并担心这个功能不够自动化其实对于学习项目来说手动更新也不是什么大问题点击一下的事。后续熟练了可以了解 Gitee 的 Go 或者 Jenkins 这类自动化发布方案新手阶段没必要。4.3 Pages 常见问题白屏、路径、自定义域名部署完发现网页打开是白屏这个现象有三种常见原因。第一种是没有index.html文件或者在docs/目录下没有部署逻辑很粗暴它只看有没有入口文件。第二种是资源路径问题JavaScript、CSS 文件用了绝对路径比如/assets/style.css而你的站点部署在子路径/仓库名/下路径对不上就会 404解决方案是改用相对路径比如./assets/style.css。第三种是引用了其他网站的资源被别人拦截了把外链资源的地址换成可以正常访问的 CDN 地址一般能解决。关于自定义域名Gitee Pages 免费版支持绑定自己的域名需要在部署页面填写域名同时去域名服务商那里配置 CNAME 记录把域名指向用户名.gitee.io。这个操作涉及 DNS 知识零基础用户可以先把默认域名用好自己买了域名再研究绑定。5. 高频问题排查速查表5.1 认证与权限类问题问题一push 时提示remote: Permission to xxx.git denied这个报错本质上是因为 Gitee 不认识当前使用的 SSH 密钥或者你没有这个仓库的写权限。排查步骤固定第一检查 SSH 密钥是否已经添加到 Gitee 账号设置页面确认公钥存在第二检查远程地址是否正确用git remote -v查看绑定的真实地址第三确认你操作的是不是自己的仓库如果是从别人那里 fork 来的通常需要发起 PR 而不是直接 push。问题二输入密码后仍然认证失败检查账号密码是否输错另外确认一下是不是开启了双重验证。开启双重验证后push 时的密码校验会有点特殊建议优先使用 SSH 方式而非 HTTP 方式鉴权也就是远程地址用gitgitee.com:用户名/仓库名.git而不是https://gitee.com/用户名/仓库名.git。问题三ssh -T gitgitee.com提示Permission denied (publickey)按 2.4 节的排查思路先检查~/.ssh/config文件里的IdentityFile路径再确认私钥权限。还有一种隐蔽情况你在生成密钥时输入了 passphrase而 SSH agentSSH 代理没有自动加载私钥需要手动执行ssh-add ~/.ssh/gitee_id_rsa把私钥添加到内存里。5.2 推送与拉取异常类问题问题四push 提示failed to push some refs to这是一个非常高频的报错。原因是远程仓库上有你本地没有的提交Git 强制要求你先同步。直接使用git pull --rebase这个命令会把远程的新提交“垫”在你的本地提交下面然后把你的提交叠加上去形成一条干净的线性历史。有些教程让你直接git pull这也可以但会产生一个额外的 merge 提交历史看起来没那么干净。问题五fatal: refusing to merge unrelated histories原因是你本地仓库和远程仓库的历史完全没有交集最常见于本地git init之后又去 Gitee 上新建了带 README 的仓库。解决方案二选一要么把远程仓库清空删除 Gitee 仓库重新建注意不要选“初始化仓库”要么执行git pull origin master --allow-unrelated-histories加上--allow-unrelated-histories参数Git 会允许两个没有共同祖先的历史进行合并。实际操作后本地文件可能和远程 README 冲突你只要保留需要的内容再提交即可。问题六用 TortoiseGit 拉取不下来的问题热词里有人问“gitee上的代码使用tortoisegit怎么拉取不下来”。TortoiseGit 是 Windows 下常用的 Git 图形化客户端。拉不下来的原因通常有几种第一URL 填错了要填仓库的 SSH 地址而不能填浏览器地址栏里的网页地址第二密钥没配置好TortoiseGit 默认使用 PuTTY 风格的密钥.ppk格式而ssh-keygen生成的 OpenSSH 格式密钥它不一定认需要在 TortoiseGit 设置里指定 SS 方式并选择正确的私钥文件第三网络代理问题如果你开了全局代理且没放行 gitee.com拉取就会卡住超时。TortoiseGit 的表现在 Windows 上略显老派如果实在搞不定我建议直接用 IDEA 或 VS Code 的图形界面体验更顺手。问题七FinalShell 怎么拉取 Gitee 里的信息FinalShell 是一个 SSH 连接工具主要是用于连接和管理服务器的。如果你想在 FinalShell 里操作 Gitee 仓库思路有两种一种是在服务器上直接执行 Git 命令把 Gitee 上的仓库克隆到服务器命令是git clone gitgitee.com:用户名/仓库名.git另一种是基于你已经登录的服务器在这个环境里生成 SSH 密钥并把公钥添加到 Gitee这样服务器和 Gitee 之间就能打通。本质和在本地电脑配置 SSH 是一样的只是承载的机器变了。5.3 仓库与页面操作类问题问题八创建 Issue 时验证码错误这个问题的原因多半是页面缓存或者浏览器插件的干扰。验证码是 Gitee 用来防机器人提交的措施如果不小心看错或者没刷新出来可以刷新一下验证码图片重新输入。浏览器装了广告拦截插件时部分脚本可能拦截了验证码加载。实在不行可以换一个无痕窗口或者切换浏览器试试一般能解决。问题九仓库里能不能包含子项目很多团队项目会有多个互相依赖的子项目大家关心的“gitee 创建的仓库能包含子项目吗”答案是肯定的。有两种组织方式一种是把多个子项目放到同一个仓库的不同目录下这种方式叫单仓库多模块适用于子项目之间有强关联的情况比如前后端一起维护。另一种是用git submoduleGit 子模块机制创建一个主仓库子仓库以子模块的形式嵌套在主仓库里面。执行添加子模块的命令是git submodule add gitgitee.com:用户名/子仓库.git子模块的优点是各个子项目可以独立维护各自的版本但缺点是增加了一层复杂度拉取主仓库后必须额外执行git submodule update --init才能把子模块代码下载下来。零基础用户如果项目规模不大我更推荐第一种方式一个仓库管所有代码简单直接。问题十Gitee 上的优秀项目怎么找热词里出现了 “erpnext gitee”“gitee mininet”“生存战争 gitee” 这些词条其实说明大家在 Gitee 上找开源项目的需求很高。Gitee 首页的“推荐项目”“全部项目”板块可以浏览热门也可以直接搜索关键词。搜索后左侧筛选栏可以按 Star 数、更新时间、语言等维度过滤。看到感兴趣的项目点进仓库页面后可以先看 README 和 Star 数判断项目是否活跃。如果只是想看看代码直接用git clone克隆到本地慢慢研究。5.4 几个不伤筋骨的日常习惯建议排查列表列完说几个我一直坚持的小习惯。每次开始写代码之前先git pull一次确保自己是基于最新版本在写这个习惯能给你省掉大量冲突处理的时间。每次提交的说明不要写“111”“222”这种一个好的提交说明能成为项目日志的一部分后期回溯 bug 时有清晰的线索。还有一条就是遇到问题先读报错信息很多人一看到英文报错就发“在线等急”其实报错信息已经把原因和解决方案写在里面了学会看报错是技术成长里性价比最高的一步。我个人在实际操作中最大的体会是Gitee 学习最难的从来不是命令本身而是对一套工作流程的心理适应。一开始你可能会觉得“每改一次代码都要 add、commit、push好麻烦”但一旦养成反射习惯这套操作流程会成为你开发效率的重要保障。当你第一次成功把自己的项目部署成 Gitee Pages再回头看这些命令你会发现它们其实比想象中简单得多。如果这篇文章帮到了你欢迎在评论区问我也可以上 Gitee 找我互动。继续折腾下去你会喜欢上这种“所有版本都被记录得清清楚楚”的感觉。