1. 项目概述
作为一名开发者,我经常需要将本地项目托管到GitHub上,并保持本地与远程仓库的同步更新。这个过程看似简单,但对于刚接触版本控制的新手来说,可能会遇到各种问题。今天我就来详细分享一套完整的操作流程,从零开始教你如何把本地项目上传到GitHub,以及后续如何更新维护。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与基础配置
2.1 Git安装与配置
首先需要在本地安装Git工具。根据你的操作系统选择对应的安装包:
- Windows: 从Git官网下载安装程序
- macOS: 使用Homebrew命令
brew install git - Linux: 使用系统包管理器安装(如Ubuntu的
sudo apt install git)
安装完成后,需要进行基础配置:
bash复制git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
提示:这里的用户名和邮箱应该与你的GitHub账户一致,这样提交记录才能正确关联到你的账户。
2.2 GitHub账户准备
如果你还没有GitHub账号,需要先注册一个。注册后建议:
- 设置SSH密钥(非必须但推荐)
- 了解基本的仓库权限设置
- 熟悉GitHub的界面布局
3. 本地项目初始化
3.1 创建本地Git仓库
进入你的项目目录,执行初始化命令:
bash复制cd /path/to/your/project
git init
这个命令会在项目目录下创建一个隐藏的.git文件夹,用于存储版本控制信息。
3.2 添加.gitignore文件
在项目根目录创建.gitignore文件,指定哪些文件不需要纳入版本控制。例如:
code复制# 忽略node_modules目录
node_modules/
# 忽略IDE配置文件
.idea/
.vscode/
# 忽略系统文件
.DS_Store
注意:合理设置.gitignore可以避免将不必要的文件(如依赖包、临时文件)上传到仓库,保持仓库整洁。
4. 上传项目到GitHub
4.1 在GitHub创建新仓库
- 登录GitHub,点
