一、注册账号与配置开发环境
使用码云前，先前往官网完成实名注册。登录后进入个人中心，绑定常用邮箱和手机号，这样能有效保障账号安全。在本地电脑打开终端或命令行窗口，输入git version确认是否已安装Git客户端。若未安装，请前往官网下载对应操作系统的安装包，全程保持默认配置即可。安装完成后，在终端依次执行git config --global user.name你的姓名和git config --global user.email你的邮箱，将身份信息写入全局配置，这一步决定了未来所有提交的归属标记。
为免去每次推送都输入密码的麻烦，强烈建议配置SSH密钥。终端输入ssh-keygen -t rsa -C你的邮箱，连续回车三次生成密钥对。随后用cat ~/.ssh/id_rsa.pub查看公钥并完整复制，登录码云网页端进入设置页面的SSH公钥管理，粘贴保存并命名。测试连通性时执行ssh git@gitee.com，看到Welcome字样即表示配置成功，后续操作均可走免密通道。
二、创建仓库与克隆项目
登录码云主页，点击右上角加号图标选择新建仓库。填写规范的仓库名称与项目简介，可勾选自动初始化README文件以便快速查看说明。根据实际需求选择公开可见或私有保密，权限设置完毕点击创建按钮。跳转至仓库详情页后，你会看到远程地址栏，提供HTTPS和SSH两种协议，日常开发推荐使用SSH地址。
将代码同步到本地工作区非常简单。打开集成终端，cd切换到你希望存放项目的目录，输入git clone加上刚才复制的SSH地址。等待进度条跑完，目标文件夹内便会自动生成完整的代码树。若只需拉取特定分支的代码，可在clone命令末尾追加-b参数并指定分支名称，节省带宽与时间。
三、日常开发与提交推送
本地拿到代码后即可着手修改。调整完毕后在终端输入git status，系统会列出新增、修改或删除的文件清单，不同颜色代表不同状态。确认无误后执行git add .将所有变动纳入暂存区，也可通过git add具体文件路径精准控制提交范围。暂存完成后运行git commit -m清晰的提交说明，日志描述务必简明扼要，注明本次修改的核心目的，方便后续追溯与协作排查。
本地验证通过后将变更同步至云端。执行git push origin main（main需替换为你实际的默认分支名）。初次推送可能触发账号校验，正常输入凭证即可，后续依赖SSH密钥将不再弹窗。若推送被拦截提示版本不一致，说明他人已先一步提交，此时切勿强制覆盖，应先拉取远程最新快照再处理。
四、团队协作与代码审查
规范团队开发应严格遵循分支隔离原则，禁止直接向主分支强行推送。先在网页端发起新建分支操作，获取分支名后在本地执行git checkout -b功能分支名进行切换。开发闭环后提交并推送至该分支。返回码云界面点击新建合并请求，选定源分支与目标主分支，填写变更摘要并指派对应人员评审。
评审人收到站内信后会在差异对比页逐行查看代码逻辑，可直接留言指出隐患或一键批准合并。审核通过后，功能代码正式汇入主干，原开发分支可按需归档删除，避免列表臃肿影响导航效率。定期执行此流程能保证主线稳定，降低联调风险。
五、常见坑位与避坑指南
新手最常遇到的报错是推送拒绝因为非快进更新。解决方法是先执行git pull origin主分支把远端变动抓取下来，手动编辑冲突标记区域解决矛盾，暂存并重新提交后再推送。另外，绝对不要将第三方依赖包目录或构建产物上传至版本库，务必在根目录创建.gitignore文件，将对应路径写入其中，否则仓库体积会迅速失控且拖慢拉取速度。
若不慎误删重要文件或写乱代码，可通过git reflog查看完整操作轨迹，定位到出问题前的commit哈希值。执行git reset --hard该哈希值即可原地回滚到健康状态。熟悉这套基础动线后，百分之九十的日常迭代都能顺畅完成，遇到高阶场景再逐步深入查阅进阶文档即可。
