cd path/to/your/project
git init
git add .
git commit -m "Initial commit: your descriptive message here"
git remote add origin <your-remote-repo-url>
第一部分：在本地初始化 Git 仓库并提交
这一步是在你的电脑上创建一个新的 Git 仓库，并将你的代码文件纳入版本管理。
步骤 1: 安装 Git
首先，确保你的电脑已经安装了 Git。
- 下载地址: https://git-scm.com/
- 检查是否安装成功：打开终端（Windows 用 CMD 或 PowerShell，Mac 用 Terminal），输入：
bash
git --version
- 如果显示了版本号（如
git version 2.37.1），说明安装成功。
步骤 2: 打开终端并进入项目目录
使用 cd 命令导航到你的项目文件夹。
bash
cd path/to/your/project
# 例如，在 Windows 上：
# cd C:\Users\YourName\MyProject
# 在 Mac 上：
# cd /Users/YourName/MyProject
步骤 3: 初始化 Git 仓库
这个命令会在当前目录创建一个新的 .git 子目录，这意味着你的项目现在开始被 Git 跟踪了。
bash
git init
步骤 4: 检查状态（可选但推荐）
这个命令会显示哪些文件已被修改、新增或删除，但还没有被 Git 跟踪（ staging area ）。
bash
git status
你会看到所有未被跟踪的文件（通常是红色的）。
步骤 5: 添加文件到暂存区
你需要告诉 Git 哪些文件需要被纳入版本控制。
- 添加所有文件（包括子目录）：
bash
git add .
注意：
git add .会添加所有文件，包括编译生成的二进制文件、日志文件等，这通常不是好习惯。最好先创建一个.gitignore文件来排除这些文件。
- 更推荐的做法：先创建
.gitignore文件
在你的项目根目录创建一个名为.gitignore的文件，里面写上需要被 Git 忽略的文件和文件夹模式。例如，一个 Python 项目的.gitignore可能包含：
text
__pycache__/
*.pyc
*.log
venv/
.env
.DS_Store
- 然后再执行
git add .。 - 添加特定文件：
bash
git add filename1.py filename2.js
再次运行 git status，你会看到文件变成了绿色，表示它们已被添加到暂存区。
步骤 6: 提交更改
将暂存区的文件创建一个快照，永久地保存到 Git 历史中。
bash
git commit -m "Initial commit: your descriptive message here"
-m 后面跟的是本次提交的说明，清晰易懂的说明非常重要。
第二部分：推送到远程仓库（如 GitHub, Gitee）
现在你的代码已经安全地保存在本地 Git 历史中了。接下来，你需要一个远程仓库来备份代码并与他人协作。
步骤 1: 创建远程仓库
在你的代码托管平台（如 GitHub）上创建一个新的空仓库。
- 登录你的 GitHub 账户。
- 点击右上角的 “+” -> “New repository”。
- 输入仓库名称（如
MyProject）。 - （可选）添加描述。
- 选择 Public（公开）或 Private（私有）。
- 非常重要：不要初始化仓库！ 不要勾选 “Add a README”, “Add .gitignore”, 或 “Choose a license”。我们希望从一个空的仓库开始，因为你本地已经有代码了。
- 点击 “Create repository”。
步骤 2: 将本地仓库与远程仓库关联
创建成功后，GitHub 会显示一个快速设置页面。你会看到两种 URL：HTTPS 和 SSH。复制你喜欢的那个（推荐使用 SSH，但需要先配置 SSH Key；HTTPS 最简单）。
![[Pasted image 20230803112845.png]]
在你的终端中，运行下面的命令，将 <your-remote-repo-url> 替换为你刚刚复制的 URL。
bash
git remote add origin <your-remote-repo-url>
# 例如，使用 HTTPS：
# git remote add origin https://github.com/your-username/your-repo-name.git
# 使用 SSH：
# git remote add origin git@github.com:your-username/your-repo-name.git
这条命令将远程仓库命名为 origin（这是惯例）。
步骤 3: 推送代码到远程仓库
最后，将你本地的 main (或 master) 分支推送到远程仓库 origin。
- 如果你的默认分支是
main（新版本 Git 的默认设置）：
bash
git push -u origin main
- 如果你的默认分支是
master（旧版本 Git 的默认设置）：
bash
git push -u origin master
-u 参数是 --set-upstream 的简写，它会将本地的 main 分支与远程的 main 分支关联起来。之后你只需要简单地使用 git push 即可。
步骤 4: 验证
刷新你的 GitHub 仓库页面，你应该能看到所有代码都已经成功上传了！
总结命令清单
整个过程的核心命令总结如下：
bash
# 1. 进入项目目录
cd /path/to/your/project
# 2. 初始化本地 Git 仓库
git init
# 3. (推荐) 创建 .gitignore 文件，排除不需要的文件
# 4. 添加所有文件到暂存区
git add .
# 5. 进行第一次提交
git commit -m "Initial commit"
# 6. 添加远程仓库地址（将 <url> 替换为你的实际 URL）
git remote add origin <url>
# 7. 推送到远程仓库
git push -u origin main # 或 master
