如何通过Git将代码成功提交至远程服务器？

准备工作：安装Git与创建远程仓库

1. 安装Git
   根据不同操作系统选择对应方式：

   • Windows：访问 Git官网 下载安装程序，按向导完成安装。
   • macOS：使用 Homebrew 执行 brew install git，或直接下载安装包。
   • Linux（Debian/Ubuntu）：终端输入 sudo apt-get install git。

2. 创建远程仓库
   在代码托管平台（如 GitHub、GitLab 或 Gitee）新建仓库，记录仓库的 SSH 或 HTTPS 地址（git@github.com:username/repo.git）。

配置Git环境

1. 设置用户信息
   终端输入以下命令，替换为你的用户名和邮箱：

   git config --global user.name "Your Name"
   git config --global user.email "your.email@example.com"

2. 生成SSH密钥（推荐）
   执行以下命令生成密钥（默认路径为 ~/.ssh）：

   ssh-keygen -t ed25519 -C "your.email@example.com"

   将公钥（id_ed25519.pub复制到远程仓库平台的 SSH Keys 设置中。

本地仓库操作：从初始化到提交

1. 初始化本地仓库
   进入项目文件夹，执行：

   git init

2. 添加文件到暂存区
   使用以下命令将文件纳入版本控制：

   git add .           # 添加所有文件
   git add filename    # 添加特定文件

3. 提交到本地仓库

   git commit -m "描述本次提交的内容"

   提示：提交信息需简洁明确，修复登录页样式错位”。

推送代码到远程仓库

1. 关联远程仓库

   git remote add origin git@github.com:username/repo.git

   origin 是远程仓库的默认别名,可自定义。

2. 推送代码

   git push -u origin main   # 首次推送需指定分支
   git push                  # 后续推送可简化命令

   注意：若远程仓库非空，需先执行 git pull 合并更改。

分支管理与协作开发

1. 创建与切换分支

   git branch feature-branch    # 新建分支
   git checkout feature-branch  # 切换分支
   git checkout -b hotfix       # 创建并切换分支（简写）

2. 合并分支到主分支

   git checkout main
   git merge feature-branch

3. 处理代码冲突
   当多人修改同一文件时，执行 git pull 后手动解决冲突，然后提交：

   git add .
   git commit -m "解决合并冲突"
   git push

最佳实践：提升代码协作效率

1. 小步提交
   每次提交仅完成一个明确功能或修复,避免大量代码堆积。

2. 规范提交信息
   采用以下格式：

   类型(作用域): 简要描述
   详细说明（可选）

   fix(auth): 修复用户登录超时问题。

3. 定期同步远程仓库

   git pull origin main   # 拉取远程最新代码

4. 使用.gitignore文件
   在项目根目录创建 .gitignore，列出需忽略的文件（如日志、临时文件）。

常见问题与解决方案

1. 权限被拒绝（Permission Denied）

   • 检查 SSH 公钥是否已添加到远程仓库。
   • 确认仓库地址是否为 SSH 格式（如 git@github.com:...）。

2. 推送失败：远程有未合并的更改

   • 执行 git pull --rebase 合并远程代码,再重新推送。

3. 误提交敏感信息

   • 使用 git filter-branch 或 BFG Repo-Cleaner 清除历史记录。

引用说明

本文参考以下资料：

• Git 官方文档
• GitHub 帮助中心
• Pro Git 电子书