Git 创建仓库
创建仓库的方法
Git提供了多种创建仓库的方式，根据你的需求选择最合适的方法：
将现有项目转换为Git仓库，开始版本控制。
- 适合已有项目
- 完全控制仓库结构
- 本地开始，后续可添加远程
复制远程仓库到本地，包括完整历史记录。
- 获取现有项目副本
- 包含完整提交历史
- 自动设置远程跟踪
将其他版本控制系统项目导入到Git。
- 从SVN、Mercurial迁移
- 保留提交历史
- 一次性迁移过程
初始化新仓库
将现有项目目录转换为Git仓库，开始版本控制。
1
进入项目目录
打开终端或命令提示符，导航到你的项目目录：
# 切换到项目目录
cd /path/to/your/project
2
初始化Git仓库
运行git init命令创建新的Git仓库：
git init
这会在当前目录创建.git子目录，其中包含所有必要的仓库文件。
3
添加文件到暂存区
将项目文件添加到Git暂存区：
# 添加所有文件
git add .
# 或添加特定文件
git add README.md index.html style.css
4
提交更改
创建项目的第一个提交：
git commit -m "Initial commit"
5
（可选）添加远程仓库
如果需要与远程仓库同步，添加远程仓库地址：
# 添加远程仓库
git remote add origin https://github.com/username/repository.git
# 推送到远程仓库
git push -u origin main
提示： 使用git init <directory>可以在指定目录创建仓库，而不是当前目录。
克隆现有仓库
克隆远程仓库到本地，获取项目的完整副本和历史记录。
1
获取仓库URL
从GitHub、GitLab或其他Git托管服务获取仓库的URL：
- HTTPS: https://github.com/username/repository.git
- SSH: git@github.com:username/repository.git
2
克隆仓库
使用git clone命令克隆仓库：
# 使用HTTPS克隆
git clone https://github.com/username/repository.git
# 使用SSH克隆
git clone git@github.com:username/repository.git
# 克隆到指定目录
git clone https://github.com/username/repository.git my-project
3
进入仓库目录
克隆完成后，进入仓库目录：
cd repository
4
验证克隆结果
检查仓库状态和远程设置：
# 查看仓库状态
git status
# 查看远程仓库信息
git remote -v
提示： 克隆仓库会自动创建远程跟踪分支，并将远程仓库设置为origin。
克隆选项
git clone命令支持多种选项：
# 只克隆最新版本（浅克隆）
git clone --depth 1 https://github.com/username/repository.git
# 克隆特定分支
git clone -b branch-name https://github.com/username/repository.git
# 克隆但不检出工作副本
git clone --bare https://github.com/username/repository.git
从其他版本控制系统导入
将SVN、Mercurial等其他版本控制系统的项目迁移到Git。
从Subversion (SVN) 导入
使用git svn工具将SVN仓库迁移到Git。
1
安装git-svn
确保已安装git-svn工具：
# Ubuntu/Debian
sudo apt install git-svn
# macOS (使用Homebrew)
brew install git-svn
2
克隆SVN仓库
使用git svn clone命令：
# 标准SVN布局（trunk, branches, tags）
git svn clone https://svn.example.com/project/ --stdlayout
# 非标准布局
git svn clone https://svn.example.com/project/ -T trunk -b branches -t tags
3
清理和优化
迁移后清理SVN特定的元数据：
# 删除SVN元数据
rm -rf .git/svn
# 运行垃圾回收优化仓库
git gc
从Mercurial导入
使用fast-export工具将Mercurial仓库迁移到Git。
1
安装转换工具
安装Mercurial和fast-export：
# 安装Mercurial
sudo apt install mercurial
# 克隆fast-export工具
git clone https://github.com/frej/fast-export.git
2
创建新的Git仓库
初始化空的Git仓库：
mkdir my-project-git
cd my-project-git
git init
3
执行转换
运行转换脚本：
# 在Git仓库目录中运行
/path/to/fast-export/hg-fast-export.sh -r /path/to/mercurial/repo
4
完成转换
检查并清理HEAD引用：
git checkout HEAD
从其他系统导入
对于其他版本控制系统，通常有专门的转换工具：
- CVS: 使用cvs2git或git cvsimport
- Perforce: 使用git p4
- Team Foundation Server: 使用git-tfs
- Bazaar: 使用bzr-fast-export
注意： 转换过程可能无法完美迁移所有元数据，建议在转换后仔细检查提交历史和分支结构。
方法比较
| 方法 |
适用场景 |
优点 |
缺点 |
| git init |
新项目或现有本地项目 |
简单快速，完全控制 |
需要手动设置远程仓库 |
| git clone |
获取现有项目副本 |
自动设置远程，包含完整历史 |
需要网络连接，依赖远程仓库 |
| git svn clone |
从SVN迁移 |
保留提交历史，支持增量更新 |
转换可能不完美，需要额外工具 |
| 导入工具 |
从其他VCS迁移 |
支持多种版本控制系统 |
过程复杂，可能需要手动调整 |
创建远程仓库
在GitHub、GitLab或Bitbucket等平台上创建远程仓库，用于团队协作和备份。
在GitHub上创建仓库
2
创建新仓库
点击右上角的 "+" 图标，选择 "New repository"。
3
填写仓库信息
- Repository name: 仓库名称
- Description: 仓库描述（可选）
- Public/Private: 选择仓库可见性
- Initialize with README: 创建初始README文件
- Add .gitignore: 选择.gitignore模板
- Choose a license: 选择许可证
4
创建仓库
点击 "Create repository" 完成创建。
在GitLab上创建仓库
2
创建新项目
点击导航栏中的 "+" 图标，选择 "New project"。
3
填写项目信息
- Project name: 项目名称
- Project URL: 项目路径
- Visibility Level: 选择可见性级别
- Initialize with README: 创建初始README
4
创建项目
点击 "Create project" 完成创建。
在Bitbucket上创建仓库
2
创建新仓库
点击左侧边栏的 "+" 图标，选择 "Repository"。
3
填写仓库信息
- Repository name: 仓库名称
- Access level: 选择访问级别
- Include a README?: 是否包含README
- Include a .gitignore?: 选择.gitignore模板
4
创建仓库
点击 "Create repository" 完成创建。
常见问题与解决
权限被拒绝错误
当尝试推送到远程仓库时出现权限错误：
Permission denied (publickey).
解决方案： 设置SSH密钥并将其添加到你的Git托管服务账户。
仓库已存在错误
初始化仓库时提示仓库已存在：
Reinitialized existing Git repository
解决方案： 当前目录已经是Git仓库，无需重复初始化。
远程仓库不存在
克隆或推送时提示远程仓库不存在：
repository not found
解决方案： 检查URL是否正确，确认仓库存在且你有访问权限。
大文件推送失败
推送包含大文件的仓库时失败：
remote: error: File is too large
解决方案： 使用Git LFS（Large File Storage）或从历史中移除大文件。