安装Git并检查运行环境
开始之前首先要确认电脑里已经装好了Git客户端。直接在Windows的命令提示符或Mac的终端里输入git version，能显示出版本号就说明没问题。如果没有安装，去Git官网下载对应系统的安装包，整个过程保持默认选项一路点击安装即可。装好后重启一下编辑器或终端，让环境变量生效，这样后续敲命令才不会找不到指令。
配置身份信息并生成密钥
打开命令行窗口，依次输入git config --global user.name你的名字和git config --global user.email你的注册邮箱，确保这两项信息和你码云后台填的一致，否则提交记录会显示未知作者。接下来配置安全连接，输入ssh-keygen -t rsa -C你的邮箱，系统会提示保存路径，直接按三次回车使用默认位置就行。然后用cat ~/.ssh/id_rsa.pub命令查看生成的公钥，全选复制这段以ssh-rsa开头的长字符串。回到码云网页端，点开右上角头像进入个人设置，找到SSH公钥菜单，把剪贴板内容粘贴进去，标题随便填个设备名，最后点确定完成绑定。
在码云平台新建项目仓库
登录码云首页，点击左上角加号图标选择新建仓库。填写项目名称和简短说明，根据需求选择公开可见还是私有加密。初始化选项建议直接选空仓库，这样能完全按照自己的节奏来管理文件。创建成功后会跳转至仓库概览页，顶部会显示两行地址，一行是HTTPS开头，另一行是git@gitee.com开头，记住SSH那一串，后面推送全靠它。
本地仓库初始化与文件暂存
把你要上传的代码文件夹放在硬盘合适的位置，右键点击空白处选择Git Bash Here，或者在命令行用cd命令切进去。输入git init初始化本地版本库，此时文件夹里会出现一个隐藏的.git目录，里面就是所有版本控制的核心数据。接着输入git add .将所有当前文件加入暂存区，如果只想传部分文件就把点替换成具体文件名。暂存完毕后执行git commit -m第一版代码说明，这相当于给这次改动盖了个章，保存到本地数据库里。
关联远程地址并执行推送
输入git remote add origin你刚才记下的SSH仓库地址，这一步是把本地仓库和云端仓库建立连接通道。如果之前配过其他地址导致报错，先用git remote remove origin清除旧配置。连接建好后输入git push -u origin main将代码推送到服务器。首次推送会进行身份校验，因为前面配了SSH密钥所以会自动通过，不需要手动输账号密码。等进度条走完，刷新码云页面就能看见完整的工程结构。注意现在主流分支名是main，老教程里的master可能需要手动调整。
常见报错排查与优化建议
上传过程中最容易碰到的是拒绝合并未合并的变更，这说明云端有本地没有的文件。这时候先跑一下git pull origin main把最新代码拉下来，手动解决冲突文件后再重新commit和push。另一个高频问题是权限不足，多半是SSH密钥没配对或者路径错了，可以输入ssh -T git@gitee.com测试连通性，看到欢迎语就证明设置成功。日常开发中建议养成小步提交的习惯，每次改完关键逻辑都打个注释清晰的标签，配合码云的对比功能，随时都能回溯到任意历史状态，彻底告别覆盖丢代码的尴尬局面。