准备工作:确保已安装 Git 并配置好环境变量。
1. 进入项目目录
很重要,进入本地这个项目目录下!

2. 配置 Git 身份(首次使用必做)
打开终端(Windows 用 Git Bash/CMD,Mac/Linux 用 Terminal),执行以下命令(替换为你的 GitHub 邮箱和用户名),用于关联本地提交记录到你的 GitHub 账号:
git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的 GitHub 绑定邮箱"
3. 先在 GitHub 上新建一个仓库(用于存储本地项目)
- 登录 GitHub 后,点击右上角「+」号 → 选择「New repository」。
- 填写仓库信息:
- Repository name:仓库名称(建议与本地项目名一致,如
my-project)。 - Description(可选):项目描述(如「我的本地开发项目」)。
- Visibility:选择「Public」(公开)或「Private」(私有,免费版可创建)。
- 取消勾选「Add a README file」(避免后续本地与远程冲突,后续可手动添加)。
- 其他选项(.gitignore、License)暂时默认,点击「Create repository」。
- Repository name:仓库名称(建议与本地项目名一致,如
- 创建成功后,复制仓库的 HTTPS 或 SSH 地址(后续关联本地项目用):点击仓库页面的「Code」按钮,复制弹出的地址(推荐用 HTTPS,下文使用 HTTPS)。


4. 初始化 Git 仓库(首次操作)
如果项目还未被 Git 管理,执行以下命令初始化(会在项目根目录创建隐藏的 .git 文件夹,用于跟踪代码变更):

5. 添加文件到暂存区
将本地项目的所有文件添加到 Git 暂存区(准备提交):
git add .



