很多开发者在写完本地代码后，都会遇到第一个难题：怎么把项目安全地传到网上备份或者团队协作？Git是目前最主流的版本管理工具，配合GitHub或Gitee等代码托管平台，能极大提升开发效率。这篇教程将用最直白的语言，带你一步步完成从安装配置到成功上传的全过程，新手也能轻松上手。
第一步安装Git并配置基础信息
打开电脑终端或命令行窗口，先确认是否已经安装Git。直接输入git version命令查看版本号。如果没有安装，可以去官网下载对应系统的安装包，一路点击下一步即可完成。安装成功后，需要设置你的全局身份信息，这是为了在每次提交记录中标注作者是谁。打开命令行，依次执行两条命令：git config global user.name你的用户名和git config global user.email你的邮箱地址。注意把引号里的内容替换成你自己真实的姓名和常用邮箱，配置完成后系统会自动保存，以后所有操作都会带上这个标识。
第二步在托管平台创建仓库
前往GitHub或国内访问更快的Gitee注册账号并登录。进入个人主页后，点击右上角的加号选择新建仓库。填写项目名称时建议用英文或数字，避免特殊字符导致后续报错。描述部分可以简单说明项目用途，勾选初始化README文件会让仓库生成一个默认文档，方便后续克隆。关键一步是权限设置，如果是个人学习项目选私有更稳妥，公开项目选公开即可。创建完毕后，平台会展示一个远程仓库地址，务必复制保存下来，后面连接本地和云端全靠它。
第三步本地初始化并关联远程仓库
回到本地电脑，打开存放项目代码的文件夹。右键选择Git Bash Here打开终端窗口，输入git init命令初始化当前目录为Git仓库，此时文件夹里会出现隐藏的.git目录。接下来把本地代码和刚才创建的远程仓库绑定，执行git remote add origin刚刚复制的仓库地址。这条命令相当于给本地仓库贴上云端的标签，origin是默认别名，后面推送时会用到。如果之前不小心绑错地址，可以用git remote remove origin解除，再重新添加一次。
第四步添加修改并提交到本地库
代码写好后不能直接上传，Git要求分步操作。先用git status查看当前哪些文件被修改或新增，状态会显示红色或绿色提示。接着执行git add dot命令把所有变动暂存起来，dot代表当前目录下所有文件。如果需要精确控制，也可以只输入git add文件名来添加特定文件。暂存完成后，执行git commit dash m提交说明文字，这里的说明要简短清晰，比如修复登录页样式或增加数据导出功能。这一步只是把改动保存到本地历史记录，还没真正传上网。
第五步推送代码到云端服务器
最后一步才是真正上传。在终端输入git push origin master，首次推送可能会要求输入GitHub或Gitee的账号密码。出于安全考虑，现在平台普遍推荐使用个人访问令牌替代密码，在设置里生成令牌并复制粘贴即可。如果遇到分支名称不是master而是main的情况，把命令末尾的master改成main就能正常推送。上传成功后终端会显示已推送多少个对象以及更新了多少分支，这时刷新网页仓库页面，就能看到完整的代码文件了。
常见问题与避坑指南
实际操作中经常会碰到拒绝推送或冲突提示。最常见的原因是云端仓库有新提交而本地没有拉取，这时候需要先执行git pull origin master同步最新内容，解决冲突后再重新推送。另一个高频问题是忘记添加文件导致上传为空，记得每次上传前都跑一遍git add和git commit。如果团队多人协作，建议养成先pull后push的习惯，保持代码库始终处于同步状态。对于大文件或图片资源，强烈建议配置.gitignore文件把它们排除在外，避免仓库体积膨胀拖慢网速。
掌握这套流程后，你就能熟练管理自己的代码资产了。Git不仅是上传工具，更是回溯历史、分支实验的神器。坚持每天提交规范的小改动，积累下来就是非常专业的开发习惯。遇到具体报错时，善用搜索引擎查询错误码，社区里有现成的解决方案。祝你编码顺利，早日构建出属于自己的高质量开源项目。
