准备工作与基础配置
很多刚接触代码管理的朋友在面对git项目上传时都会感到无从下手，其实只要理清步骤，整个过程非常直观。本文将用最直白的大白话，带你一步步把本地项目推送到远程仓库，全程不绕弯子，适合零基础开发者直接照做。在动手之前，请确保你的电脑已经安装好了git客户端。可以在终端或命令行里输入git version查看版本号，有显示就说明装好了。安装完成后，第一步是告诉git你是谁，因为每次提交都需要记录作者信息。打开命令行窗口，依次执行两条命令：先设置用户名git config --global user.name你的名字，再设置邮箱git config --global user.email你的邮箱地址。这两条命令只需执行一次，以后所有操作都会自动带上这些信息。建议邮箱填写你在github或gitee注册时用的那个，这样方便关联账号。
初始化本地仓库
接下来处理你要上传的项目文件夹。假设你的项目放在桌面一个叫myproject的文件夹里。先用cd命令切换路径到该文件夹根目录，然后输入git init。这个命令会在当前目录下生成一个隐藏的.git文件夹，这就是项目的版本控制中心。看到提示successfully initialized就代表本地仓库创建完成。此时文件夹里还只是普通文件，git还没有开始跟踪它们。
添加文件并提交快照
git不会自动抓取所有新文件，你需要手动把它们加入暂存区。输入git add .可以一次性把当前目录下所有新增和修改的文件都加进去，点号代表所有文件。如果只想传某个特定文件，就把点号换成文件名。加完之后别急着推送，git讲究工作流，得先生成一个提交记录。用git commit -m描述信息来保存状态，引号里的内容要简单说明这次改了啥，比如首次上传或者修复登录bug。这一步相当于给当前进度拍了一张照片，随时可以回退到这张照片的状态。
绑定远程仓库地址
现在本地搞定了，得把它跟云端连起来。去github或者gitee新建一个空仓库，记下它给的https链接。回到命令行，输入git remote add origin刚才复制的链接地址。origin只是远程仓库的默认别名，你也可以叫别的名字，但用origin最符合团队习惯。这条命令相当于给本地仓库贴了一张指向云端的快递单，后续的所有操作都会顺着这张单子走。
执行上传推送
一切就绪后，最后一步就是真正推送到服务器。输入git push -u origin main。这里main指的是目标分支名，如果你创建仓库时选的是master，就把main改成master。第一次推送会要求你输入账号密码，如果是github可能需要用个人访问令牌代替密码，按页面提示生成并粘贴即可。看到push complete或者success字样就说明文件已经安全躺在云端了。以后每次改动完，只需要重复add和commit，然后再次运行这条push命令就能同步更新。
常见问题排查技巧
上传成功后，建议立刻去网页端刷新仓库主页，确认文件列表是否完整，尤其是注意.gitignore文件有没有生效。很多人第一次传上去发现多了依赖包或者编译产物，就是因为没提前写好忽略规则。在提交前养成检查git status的习惯，白色文字代表未跟踪，绿色代表已暂存，红色代表已修改但未暂存，看清颜色再操作能省掉大量返工时间。如果遇到permission denied报错，多半是远程地址填错或者权限没开，回去检查一下链接对不对。要是提示already up to date，说明本地比云端旧或者完全一致，这时候用pull先把最新代码拉下来再合并就行。还有种情况是冲突报错，这通常发生在多人协作时，先执行git status看看哪些文件打架，手动改好冲突标记后再重新提交。平时养成频繁小步提交的习惯，能避免很多大改动带来的麻烦。记住git的核心就是记录变化，只要掌握增删改查的基本节奏，项目上传就不再是难题，彻底告别手动打包压缩传文件的笨办法。
