一、准备工作
1. 安装 Git
Windows ：下载安装包
macOS ：在终端运行 brew install git
Linux：
bash
复制代码
# Ubuntu/Debian
sudo apt update && sudo apt install git
# CentOS/Fedora
sudo yum install git
2. 配置用户信息（首次使用）
bash
复制代码
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
3. 创建代码仓库（本地）
bash
复制代码
# 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. 添加文件到暂存区
bash
复制代码
# 添加所有文件（排除.gitignore中的文件）
git add .
# 或者添加特定文件
git add file1.py file2.js
3. 查看当前状态
bash
复制代码
git status
绿色文件表示已添加到暂存区，红色文件表示未跟踪
三、创建首次提交
bash
复制代码
git commit -m "项目初始提交"
四、创建远程仓库（以GitHub为例）
1. 创建GitHub账号
访问 github.com 注册账号
2. 创建新仓库
点击右上角 ➕ > New repository
填写仓库名称（建议与项目名一致）
选择 Public（公开）或 Private（私有）
不要勾选 "Initialize this repository with a README"
点击 Create repository
五、连接本地与远程仓库
1. 获取远程仓库URL
创建成功后，复制显示的HTTPS或SSH URL：
复制代码
https://github.com/你的用户名/仓库名.git
2. 添加远程仓库
bash
复制代码
git remote add origin https://github.com/你的用户名/仓库名.git
3. 验证连接
bash
复制代码
git remote -v
# 应显示：
# originhttps://github.com/你的用户名/仓库名.git (fetch)
# originhttps://github.com/你的用户名/仓库名.git (push)
六、推送代码到远程仓库
bash
复制代码
git push -u origin main
第一次推送使用 -u 参数设置跟踪关系
七、后续开发工作流
1. 日常开发流程
bash
复制代码
# 1. 修改文件
# 2. 查看修改状态
git status
# 3. 添加修改到暂存区
git add 修改的文件名
# 或添加所有修改
git add .
# 4. 提交更改
git commit -m "描述本次修改的内容"
# 5. 推送到远程
git push
2. 常用命令速查
命令
用途
git diff
查看未暂存的修改
git log
查看提交历史
git pull
拉取远程更新
git branch
查看分支
git checkout -b 新分支
创建新分支
八、重要注意事项
1. 避免上传敏感信息
不要在代码中包含密码、API密钥等
使用环境变量管理敏感信息
如果误上传了敏感信息：
立即删除文件
修改所有相关密钥
使用 git filter-branch 从历史记录中清除
2. 提交规范
提交信息要清晰描述修改内容
使用动词开头："添加"、"修复"、"更新"等
示例：
git commit -m "修复用户登录失败的问题"
git commit -m "添加用户管理模块"
3. 分支管理策略
bash
复制代码
# 创建功能分支
git checkout -b feature/new-module
# 开发完成后合并到主分支
git checkout main
git merge feature/new-module
# 删除已合并的分支
git branch -d feature/new-module
九、遇到问题怎么办？
常见问题解决：
认证失败：
使用SSH代替HTTPS
生成SSH密钥：ssh-keygen -t ed25519 -C "your_email@example.com"
将公钥(~/.ssh/id_ed25519.pub)添加到GitHub账户设置
文件冲突：
bash
复制代码
# 拉取最新代码时解决冲突
git pull
# 手动解决冲突后
git add 冲突文件
git commit -m "解决合并冲突"
撤销修改：
bash
复制代码
# 撤销未暂存的修改
git checkout -- 文件名
# 撤销已暂存未提交的修改
git reset HEAD 文件名
十、高级技巧（可选）
1. 使用Git GUI工具
GitKraken
Sourcetree
VS Code内置Git功能
2. 设置自动化钩子
在 .git/hooks 中添加脚本：
bash
复制代码
# pre-commit 示例（提交前运行测试）
#!/bin/sh
pytest tests/
if [ $? -ne 0 ]; then
echo "测试失败，提交中止"
exit 1
fi
3. 使用Git LFS管理大文件
bash
复制代码
# 安装Git LFS
git lfs install
# 跟踪大文件类型
git lfs track "*.psd"
git lfs track "*.mp4"
完整工作流示例
bash
复制代码
# 开始新功能开发
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
通过这套流程，即使是完全的新手也能安全高效地管理项目代码。建议开始时先在一个测试项目上练习，熟悉后再应用到正式项目中。