---

一、 准备工作

1. 安装 Git

• 下载地址：Git 官网
• 安装建议：下载对应系统的安装包，一路点击“Next”选择默认选项即可。
• 验证安装：打开命令行（Terminal 或 CMD），输入以下命令。显示版本号即代表安装成功：
  bash git --version

2. 配置 SSH 密钥（可选但推荐）

使用 SSH 协议连接可以避免每次推送代码都要输入密码。

• 生成密钥（一路回车即可）：
  bash ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
• 获取公钥：
  bash cat ~/.ssh/id_rsa.pub
  复制输出的内容，将其添加到你 Git 平台的 SSH Keys 设置中。

3. 创建远程仓库

在你的 Git 服务器（GitHub/GitLab）上新建一个项目（New Repository），不要勾选 “Initialize this repository with a README”，因为我们要上传本地已有的项目。

• 获取仓库地址，例如：git@github.com:username/repo.git

---

二、 上传本地项目

第一步：进入项目目录

在命令行中切换到你的项目根目录：

cd C:\Project\shuju  # 替换为你实际的项目路径

第二步：初始化本地仓库

将该目录变成 Git 可以管理的仓库：

git init

第三步：配置用户信息

如果是第一次使用 Git，需要告诉 Git 你是谁：

# 全局配置（所有仓库通用）
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

第四步：编写 .gitignore 文件

这一步至关重要！ 避免将庞大的依赖包（如 node_modules）或敏感配置上传。
在项目根目录创建 .gitignore 文件，内容示例：

# 依赖文件
node_modules/
npm-debug.log

# 编译产物
dist/
bin/
obj/

# IDE 配置文件
.idea/
.vscode/
*.suo

第五步：添加文件到暂存区

git add .  # 添加所有文件（受 .gitignore 保护）

第六步：提交代码到本地仓库

git commit -m "feat: 首次提交，初始化项目"

第七步：关联远程仓库

将本地仓库与远程地址进行绑定：

# 请将地址替换为你实际的仓库地址
git remote add origin git@github.com:username/repo.git

第八步：推送代码

# 首次推送，-u 会关联本地与远程分支，以后只需 git push
git push -u origin master 

# 注意：现代仓库（如 GitHub）默认分支名可能是 main
# 如果你想推送到 main，请使用：
# git branch -M main
# git push -u origin main

---

三、 常见问题与解决方案

1. 身份认证失败 (Please tell me who you are)

原因：未配置 Git 用户名和邮箱。
解决：执行第三步中的 git config 命令。

2. 权限拒绝 (Permission denied (publickey))

原因：SSH 密钥未配置或配置错误。
解决：检查 SSH 公钥是否已上传至服务器，或改用 HTTPS 链接。

3. 推送失败 (Failed to push some refs)

原因：远程仓库已经有文件（如 README），导致本地与远程不一致。
解决：

git pull --rebase origin master
git push -u origin master

4. 远程仓库地址写错了

解决：

git remote set-url origin <新的地址>

---

四、 Git 常用命令速查表

命令	说明
git status	查看当前文件状态
git log	查看提交历史记录
git branch	查看本地分支
git checkout -b <name>	创建并切换到新分支
git merge <name>	将指定分支合并到当前分支
git pull	拉取远程代码并合并
git remote -v	查看远程仓库详细地址

---

---