Git是什么？简单说，它是一个“版本控制系统”，就像一个“文件日记”，能帮你记录文件的每一次修改，还能多人协作编辑。GitHub则是基于Git的“在线仓库平台”，你可以把本地的代码存到GitHub上，也能和别人一起修改代码。
一、准备工作¶
- 安装Git：先在电脑上安装Git工具。Windows用户可以去Git官网下载，安装时按默认选项一路下一步即可；Mac用户可以用Homebrew（
brew install git）或直接官网下载。安装完成后，打开终端（Windows用“Git Bash”），输入git --version，如果显示版本号，说明安装成功。 - 注册GitHub账号：去GitHub官网注册一个账号，登录后就可以创建仓库了。
二、在GitHub上创建仓库¶
仓库就像一个文件夹，用来存放你的项目代码。
- 登录GitHub并创建仓库
- 登录后，点击右上角的“+”号，选择“New repository”（新建仓库）。
- 填写仓库信息：- Repository name：仓库名称（比如“my-first-project”，只能用英文和数字，不能有空格）。
- Description：简单描述（比如“我的第一个GitHub项目”，可选填）。
- Visibility：选“Public”（公开，所有人可见）或“Private”（私有，仅自己可见，免费用户只能创建1个私有仓库，新手先用Public）。
- 勾选“Add a README file”：自动生成一个说明文件（后续拉取时用，避免冲突）。
- 其他选项：暂时不用管（.gitignore和license可以后面再配置）。
- 点击“Create repository”，仓库就创建成功了。此时页面会显示仓库地址（比如
https://github.com/你的用户名/my-first-project.git），先复制下来备用。
三、本地项目关联到GitHub仓库¶
假设你的本地项目在文件夹“my-project”里，里面有文件（比如index.html、style.css）。
1. 初始化本地Git仓库¶
打开终端，进入本地项目文件夹（比如Windows用cd C:\Users\你的用户名\my-project，Mac用cd ~/my-project）。
输入命令：git init
此时文件夹里会出现一个隐藏的.git文件夹，说明本地仓库初始化成功。
2. 关联远程GitHub仓库¶
输入命令：git remote add origin [刚才复制的仓库地址]
比如：git remote add origin https://github.com/你的用户名/my-first-project.git
这一步是把本地仓库和GitHub上的仓库“绑定”，origin是远程仓库的别名（固定用origin即可）。
3. 拉取远程仓库内容（避免冲突）¶
如果GitHub仓库里有README文件（之前勾选了“Add a README”），需要先拉取远程内容到本地，否则直接push会报错。
输入命令：git pull origin main（注意：现在很多仓库用main分支，旧仓库可能用master，如果报错，换成master试试）。
如果拉取成功，本地就有了README文件，避免后续push时文件冲突。
4. 提交本地文件到GitHub¶
- 暂存文件：把本地修改的文件“打包”到暂存区，输入
git add .（.表示所有文件，也可以写具体文件名，比如git add index.html）。 - 提交到本地仓库：给这次修改写个“备注”，输入
git commit -m "Initial commit"（引号里是备注，比如“第一次上传项目”）。 - 推送到远程仓库：把本地提交的内容推到GitHub，输入
git push origin main。
此时，GitHub仓库页面就能看到你上传的文件了！
四、基本命令速记¶
| 命令 | 作用 |
|---|---|
git init |
初始化本地Git仓库（让文件夹可被Git管理） |
git add . |
把所有修改的文件暂存到“准备提交区” |
git commit -m "..." |
把暂存区的文件提交到本地仓库，"..."是备注内容 |
git push origin main |
把本地仓库的内容推到GitHub的main分支 |
git pull origin main |
拉取GitHub仓库的最新内容到本地（避免文件冲突） |
五、常见问题¶
- Q：提示“远程仓库已存在”？
A：可能是本地仓库和远程仓库重复关联了，先输入git remote -v查看关联的地址，然后用git remote remove origin删除旧关联，再重新add origin。 - Q：没有README文件，push时报错？
A：用git pull origin main拉取远程仓库的README（如果有），再提交。 - Q：需要多人协作？
A：后续可以学习git branch（分支）、git merge（合并）和git clone（克隆仓库），但基础阶段先掌握“创建+提交”即可。
现在，你的本地项目已经和GitHub仓库关联成功，以后修改文件后，重复执行git add .→git commit -m "修改说明"→git push origin main，就能把更新推到GitHub上了！