企业官网建设流程全解析

1. 项目概述：为什么需要将本地项目推送到Gitee远程仓库

作为国内开发者最常用的代码托管平台之一，Gitee提供了稳定的Git仓库服务。将本地项目推送到远程仓库不仅是代码备份的基本操作，更是团队协作开发的必要前提。我经历过多次硬盘故障导致代码丢失的惨痛教训，现在养成了"编码即提交"的职业习惯。

与GitHub相比，Gitee的国内访问速度优势明显，特别是在没有特殊网络环境的情况下。对于个人项目或小型团队，Gitee的免费私有仓库额度完全够用。下面这个操作流程我已经在Windows/macOS/Linux三大平台验证过数十次，适用于任何Git管理的项目。

2. 环境准备与基础配置

2.1 Git客户端安装指南

无论使用哪个操作系统，都需要先安装Git客户端：

• Windows：建议下载Git for Windows（包含Git Bash）
• macOS：通过Homebrew执行brew install git
• Linux：使用系统包管理器（如apt install git）

安装完成后，在终端运行以下命令检查版本：

git --version

2.2 Gitee账户配置要点

1. 注册Gitee账号后，务必设置SSH公钥：

ssh-keygen -t rsa -C "your_email@example.com" cat ~/.ssh/id_rsa.pub

2. 将输出的公钥内容粘贴到Gitee的SSH公钥管理页面
3. 测试连接是否成功：

ssh -T git@gitee.com

注意：如果提示"Permission denied"，请检查Gitee账户邮箱是否与生成密钥时填写的邮箱一致

3. 本地项目初始化流程

3.1 新建仓库的两种场景

场景一：从零开始的新项目

mkdir my-project cd my-project git init touch README.md git add . git commit -m "initial commit"

场景二：已有项目接入Git

cd existing-project git init git add --all git commit -m "迁移现有项目到Git"

3.2 .gitignore文件的最佳实践

建议在项目根目录创建.gitignore文件，常见配置：

# 忽略系统文件 .DS_Store Thumbs.db # 忽略IDE配置 .idea/ .vscode/ # 忽略依赖目录 node_modules/ vendor/ # 忽略编译产物 *.exe *.dll *.class

4. 远程仓库操作全流程

4.1 在Gitee创建远程仓库

1. 登录Gitee点击"新建仓库"
2. 填写仓库名称（建议与本地项目名一致）
3. 选择私有/公开权限
4. 初始化选项选择"不初始化仓库"

4.2 本地与远程仓库关联

获取仓库SSH地址后（格式如：git@gitee.com:username/repo.git），执行：

git remote add origin git@gitee.com:username/repo.git git branch -M main # 新版Git默认分支名 git push -u origin main

常见报错处理：如果提示"remote origin already exists"，先执行git remote remove origin

4.3 推送更新的标准流程

日常开发中的提交规范：

git add . git commit -m "描述性提交信息" git pull --rebase # 推荐使用rebase代替merge git push

5. 高级配置与实用技巧

5.1 多远程仓库配置

有些项目需要同时推送到Gitee和GitHub：

git remote add gitee git@gitee.com:user/repo.git git remote add github git@github.com:user/repo.git

推送时指定远程：

git push gitee main git push github main

5.2 更改历史提交的author信息

当发现提交者信息错误时：

git filter-branch --env-filter ' OLD_EMAIL="wrong@email.com" CORRECT_NAME="Your Name" CORRECT_EMAIL="correct@email.com" if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] then export GIT_COMMITTER_NAME="$CORRECT_NAME" export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" fi if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] then export GIT_AUTHOR_NAME="$CORRECT_NAME" export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" fi ' --tag-name-filter cat -- --branches --tags

5.3 大文件存储方案

当需要管理超过100MB的文件时：

1. 安装Git LFS：

git lfs install

2. 指定要追踪的大文件类型：

git lfs track "*.psd" git lfs track "*.zip"

3. 将生成的.gitattributes文件加入版本控制：

git add .gitattributes

6. 常见问题排查手册

6.1 认证失败问题

现象：推送时提示"Permission denied"

• 检查SSH密钥是否已添加到Gitee账户
• 测试SSH连接：ssh -T git@gitee.com
• 临时切换HTTPS协议：

git remote set-url origin https://gitee.com/user/repo.git

6.2 冲突解决流程

当git pull提示冲突时：

1. 查看冲突文件：

git status

2. 手动编辑标记了"<<<<<<<"的文件
3. 标记冲突已解决：

git add conflicted_file.js git rebase --continue

6.3 误提交文件处理

移除已提交但不应在仓库的文件：

git rm --cached sensitive_file.txt echo "sensitive_file.txt" >> .gitignore git add .gitignore git commit -m "移除敏感文件"

7. 自动化部署延伸应用

结合Gitee Pages实现静态网站自动部署：

1. 在仓库设置中开启Gitee Pages服务
2. 指定部署分支（如docs或gh-pages）
3. 通过Webhook实现提交后自动构建

示例构建脚本（.gitee/webhook.sh）：

#!/bin/bash git checkout docs npm install npm run build cp -R dist/* . git add . git commit -m "自动更新站点" git push origin docs

对于需要频繁操作的项目，我习惯在package.json中添加快捷命令：

{ "scripts": { "deploy": "git add . && git commit -m '自动提交' && git push" } }

实际开发中，保持提交历史的整洁非常重要。我推荐使用交互式rebase来整理本地提交记录：

git rebase -i HEAD~5

这个操作可以合并、修改或重新排序最近的5次提交，在推送到远程前让提交历史更加清晰可读。养成这种好习惯，当项目需要回溯历史或排查问题时，你会感谢自己的严谨。