很多刚接触版本控制的开发者都会遇到一个问题，本地代码写好了，怎么安全地传到GitHub或Gitee等平台上。其实只要掌握几个核心命令，整个过程非常清晰。下面按实际操作顺序一步步说明，避免你卡在某个环节，同时补充常见报错的解决方法。
前期配置与环境检查
先准备好基础环境。确保电脑已经正确安装Git，并且注册了目标代码托管平台的账号。如果是首次使用，必须配置全局的用户名和邮箱，这步绝对不能跳过，否则后续提交会被系统拦截。打开终端或命令行工具，依次输入git config --global user.name你的名字和git config --global user.email你的邮箱地址。替换成真实信息后，系统就能准确记录代码变更的作者身份。配置完毕可以输入git config --list核对一下是否生效，看到对应的键值对即表示成功。
初始化本地仓库与暂存文件
打开终端，使用cd命令切换到你的项目根目录。不管是刚建好的空文件夹，还是从别处拷贝过来的源码，都需要在这里建立版本控制。执行git init指令，目录下会生成隐藏的.git文件夹，它是整个项目的控制中心。接着把需要上传的文件加入追踪队列，输入git add .表示把当前目录下所有未跟踪的文件全部纳入管理。如果想精准控制，也可以单独指定文件名。这一步只是把文件状态标记为待提交，并没有真正保存记录，属于工作区到暂存区的流转。
创建提交快照与关联远程地址
暂存完成后，下一步是生成正式的提交记录。输入git commit -m简洁明了的修改说明，引号内要写明本次动作的具体内容，例如修复首页加载异常或接入支付接口。这个快照机制能让你随时回溯历史版本。紧接着建立本地与云端的桥梁，在托管平台新建仓库并复制提供的HTTPS或SSH链接。回到终端运行git remote add origin粘贴的网址，origin是官方约定的远程仓库标识符。如果之前配置过错误的地址，记得先用git remote remove origin清除缓存再重新绑定。
执行推送操作与安全认证
一切就绪后，输入git push -u origin master发起正式传输。这里的master指代默认主分支，部分平台已改为main，请根据实际显示调整。加上-u参数是为了让Git自动建立本地分支与远程分支的映射关系，之后直接敲git push即可完成增量同步。等待进度条结束，刷新网页确认文件列表已更新。推送时若提示密码失效，是因为主流平台已全面弃用账户密码验证。需要在设置页面生成个人访问令牌，并在命令行中填入令牌值，或者提前配置SSH公钥实现免密通信，一劳永逸解决认证麻烦。
处理常见冲突与后续维护
团队协作中难免遇到分支分歧，直接推送可能触发拒绝请求。此时应先运行git pull origin master拉取他人最新改动，手动合并代码后解决文件冲突，再次提交才能继续上传。日常开发建议保持频繁的小步提交习惯，避免累积太多改动导致回滚困难。定期清理不需要的临时分支，保持仓库结构整洁。遇到问题时直接复制终端报错信息搜索，绝大多数情况都有现成解决方案。熟练运用这套流程后，代码同步将变得极其顺畅，项目管理也会更加规范高效。
