Git 从零开始：完整项目上传指南

一、准备工作

1. 安装 Git

• Windows：下载安装包
• macOS：在终端运行 brew install git
• Linux：

# Ubuntu/Debian
sudo apt update && sudo apt install git

# CentOS/Fedora
sudo yum install git

2. 配置用户信息（首次使用）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

3. 创建代码仓库（本地）

# 1. 打开终端/命令提示符
# 2. 进入项目目录
cd /path/to/your/project

# 3. 初始化Git仓库
git init

二、添加项目文件到Git

1. 创建 .gitignore 文件（重要！）

在项目根目录创建 .gitignore 文件，内容示例：

# 忽略系统文件
.DS_Store
Thumbs.db

# 忽略编辑器文件
.idea/
.vscode/
*.swp

# 忽略Python虚拟环境
venv/
.env

# 忽略编译文件
__pycache__/
*.pyc

2. 添加文件到暂存区

# 添加所有文件（排除.gitignore中的文件）
git add .

# 或者添加特定文件
git add file1.py file2.js

3. 查看当前状态

git status

绿色文件表示已添加到暂存区，红色文件表示未跟踪

三、创建首次提交

git commit -m "项目初始提交"

四、创建远程仓库（以GitHub为例）

1. 创建GitHub账号

访问 github.com 注册账号

2. 创建新仓库

1. 点击右上角 ➕ > New repository
2. 填写仓库名称（建议与项目名一致）
3. 选择 Public（公开）或 Private（私有）
4. 不要勾选 “Initialize this repository with a README”
5. 点击 Create repository

五、连接本地与远程仓库

1. 获取远程仓库URL

创建成功后，复制显示的HTTPS或SSH URL：

https://github.com/你的用户名/仓库名.git

2. 添加远程仓库

git remote add origin https://github.com/你的用户名/仓库名.git

3. 验证连接

git remote -v
# 应显示：
# originhttps://github.com/你的用户名/仓库名.git (fetch)
# originhttps://github.com/你的用户名/仓库名.git (push)

六、推送代码到远程仓库

git push -u origin main

第一次推送使用 -u 参数设置跟踪关系

七、后续开发工作流

1. 日常开发流程

# 1. 修改文件
# 2. 查看修改状态
git status

# 3. 添加修改到暂存区
git add 修改的文件名
# 或添加所有修改
git add .

# 4. 提交更改
git commit -m "描述本次修改的内容"

# 5. 推送到远程
git push

2. 常用命令速查

八、重要注意事项

1. 避免上传敏感信息

• 不要在代码中包含密码、API密钥等
• 使用环境变量管理敏感信息
• 如果误上传了敏感信息：

1. 立即删除文件
2. 修改所有相关密钥
3. 使用 git filter-branch 从历史记录中清除

2. 提交规范

• 提交信息要清晰描述修改内容
• 使用动词开头：“添加”、“修复”、"更新"等
• 示例：

git commit -m "修复用户登录失败的问题"
git commit -m "添加用户管理模块"

3. 分支管理策略

# 创建功能分支
git checkout -b feature/new-module

# 开发完成后合并到主分支
git checkout main
git merge feature/new-module

# 删除已合并的分支
git branch -d feature/new-module

九、遇到问题怎么办？

常见问题解决：

1. 认证失败：

• 使用SSH代替HTTPS
• 生成SSH密钥：ssh-keygen -t ed25519 -C "your_email@example.com"
• 将公钥(~/.ssh/id_ed25519.pub)添加到GitHub账户设置

2. 文件冲突：

# 拉取最新代码时解决冲突
git pull
# 手动解决冲突后
git add 冲突文件
git commit -m "解决合并冲突"

3. 撤销修改：

# 撤销未暂存的修改
git checkout -- 文件名

# 撤销已暂存未提交的修改
git reset HEAD 文件名

十、高级技巧（可选）

1. 使用Git GUI工具

• GitKraken
• Sourcetree
• VS Code内置Git功能

2. 设置自动化钩子

在 .git/hooks 中添加脚本：

# pre-commit 示例（提交前运行测试）
#!/bin/sh
pytest tests/
if [ $? -ne 0 ]; then
echo "测试失败，提交中止"
exit 1
fi

3. 使用Git LFS管理大文件

# 安装Git LFS
git lfs install

# 跟踪大文件类型
git lfs track "*.psd"
git lfs track "*.mp4"

完整工作流示例

# 开始新功能开发
git checkout main
git pull
git checkout -b feature/user-profile

# 开发过程...
git add .
git commit -m "添加用户资料页面"
git push -u origin feature/user-profile

# 合并到主分支
git checkout main
git pull
git merge feature/user-profile
git push

# 清理分支
git branch -d feature/user-profile

通过这套流程，即使是完全的新手也能安全高效地管理项目代码。建议开始时先在一个测试项目上练习，熟悉后再应用到正式项目中。