如何让 Git 管理本地项目

---

如何让 Git 管理本地项目：详细步骤指南

Git 是最流行的分布式版本控制系统，能够高效管理项目的代码变更历史。以下是将本地项目交给 Git 管理的完整流程，适用于首次使用 Git 的开发者。

---

一、前置条件

1. 安装 Git

---

二、初始化 Git 仓库

1. 进入项目根目录
   打开终端，使用 cd 命令切换到你的项目文件夹：

   cd /path/to/your/project
   

2. 初始化本地仓库
   执行以下命令，将当前目录变为 Git 管理的仓库：

   git init
   

   • 这会创建一个隐藏的 .git 文件夹，存储 Git 的所有版本控制数据。
   • 只需执行一次，重复执行不会覆盖已有仓库。

---

三、添加文件到 Git 管理

1. 查看当前状态
   运行以下命令，查看哪些文件未被 Git 跟踪（红色显示未跟踪文件）：

   git status
   

2. 添加文件到暂存区

   • 添加单个文件：

     git add filename.txt
     

   • 添加所有文件：

     git add .
     

     • git add . 会将当前目录及子目录下的所有新文件和修改添加到暂存区。
     • 若需排除某些文件（如日志、临时文件），需配置 .gitignore（见下文）。

3. 验证暂存区内容
   再次运行 git status，绿色显示的文件已进入暂存区，等待提交。

---

四、提交代码到本地仓库

1. 执行提交操作
   将暂存区的文件永久保存到 Git 仓库的历史记录中：

   git commit -m "Initial commit"
   

   • -m 后跟提交说明，需简洁明确（如“修复登录BUG”“添加用户模块”）。

2. 查看提交记录

   git log
   

   • 显示提交历史，包括提交者、时间、提交信息（按 q 退出）。

---

五、进阶配置（可选）

1. 配置忽略文件（.gitignore）
   在项目根目录创建 .gitignore 文件，列出不需要 Git 跟踪的文件或目录，例如：

   # 忽略日志文件
   *.log
   
   # 忽略临时文件夹
   /tmp/
   
   # 忽略IDE配置文件
   .idea/
   .vscode/
   
   # 忽略依赖目录
   node_modules/
   

   • 使用 git add .gitignore 将其提交到仓库。

2. 连接远程仓库（如GitHub/Gitee）

   • 在远程平台（如 GitHub）创建空仓库。
   • 本地执行以下命令关联远程仓库：

     git remote add origin https://github.com/yourname/repo.git
     

   • 推送本地代码到远程仓库：

     git push -u origin master  # 首次推送需加 -u 参数
     

---

六、完整操作示例

# 进入项目目录
cd ~/projects/my-app

# 初始化仓库
git init

# 添加所有文件到暂存区
git add .

# 提交到本地仓库
git commit -m "Initial project setup"

# （可选）关联远程仓库并推送
git remote add origin https://github.com/user/my-app.git
git push -u origin master

---

七、注意事项

1. 不要手动修改 .git 文件夹，否则可能导致仓库损坏。
2. 敏感信息（如密码、密钥）不要提交到 Git，可通过 .gitignore 排除。
3. 提交前务必检查 git status，确认只添加需要的文件。
4. 推荐频繁提交（小步提交），保持提交记录的清晰性。

---