1. 项目概述
作为一名开发者,我经常需要将本地项目上传到GitHub进行版本管理和团队协作。刚开始接触Git时,我也曾对命令行操作感到困惑,经过多次实践才掌握了这套工作流。本文将详细分享从零开始上传本地项目到GitHub,以及后续更新维护的完整流程。
Git作为目前最流行的分布式版本控制系统,能有效管理代码变更历史。而GitHub作为全球最大的代码托管平台,不仅提供代码存储功能,还支持问题跟踪、持续集成等开发者工具。掌握Git与GitHub的协同使用,是每个程序员必备的基础技能。
本文将分为两大部分:第一部分讲解如何将全新的本地项目首次推送到GitHub仓库;第二部分介绍如何将本地修改同步到已存在的远程仓库。我会在每个步骤中穿插实际操作的注意事项和个人经验总结。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与初始配置
2.1 Git安装与基础配置
在开始之前,我们需要确保本地环境已经安装并配置好Git。Windows用户可以从Git官网下载Git Bash,它提供了完整的Git功能和类Unix命令行环境。
安装完成后,建议先进行全局配置,设置用户名和邮箱(这些信息会记录在每次提交中):
bash复制git config --global user.name "你的姓名"
git config --global user.email "你的邮箱"
注意:这里的邮箱建议使用GitHub账号绑定的邮箱,这样提交记录才能正确关联到你的GitHub账号。
2.2 GitHub账号与仓库准备
登录GitHub账号后,点击右上角"+"按钮选择"New repository"创建新仓库。在创建页面有几个关键选项需要注意:
- Repository name:仓库名称,建议使用简短清晰的英文
- Description:项目描述(可选)
- Public/Private:选择公开或私有仓库
- Initialize this repository with:通常保持为空,我们从本地推送已有项目
创建完成后,GitHub会显示仓库的HTTPS地址,形如https://github.com/用户名/仓库名.git,这个地址在后续步骤中会用到。
3. 本地项目首次推送流程
3.1 初始化本地Git仓库
进入项目根目录,右键选择
