创建和管理仓库

Git 仓库(Repository)是你项目的容器,包含了项目的所有文件和历史记录。本节将介绍如何创建和管理 Git 仓库。

创建新仓库

方法一:初始化新仓库

  1. 创建项目目录:

    mkdir my-project
    cd my-project
  2. 初始化 Git 仓库:

    git init

    这个命令会创建一个 .git 目录,用于存储仓库的所有版本信息。

  3. 验证仓库状态:

    git status

方法二:克隆现有仓库

  1. 使用 HTTPS 克隆:

    git clone https://github.com/username/repository.git
  2. 使用 SSH 克隆(需要配置 SSH 密钥):

    git clone git@github.com:username/repository.git

仓库配置

本地配置

  1. 查看当前配置:

    git config --list
  2. 设置用户信息:

    git config user.name "Your Name"
    git config user.email "your.email@example.com"
  3. 设置默认分支名:

    git config init.defaultBranch main

远程仓库配置

  1. 添加远程仓库:

    git remote add origin <repository-url>
  2. 查看远程仓库:

    git remote -v
  3. 修改远程仓库地址:

    git remote set-url origin <new-repository-url>

仓库维护

基本维护命令

  1. 检查仓库状态:

    git status
  2. 查看提交历史:

    git log
  3. 查看特定文件的历史:

    git log -p <file>

仓库清理

  1. 清理未跟踪的文件:

    git clean -n  # 预览要清理的文件
    git clean -f  # 实际清理文件
  2. 压缩仓库:

    git gc

最佳实践

  1. 仓库结构

    • 保持清晰的目录结构
    • 使用适当的 .gitignore 文件
    • 及时清理不需要的文件
  2. 配置管理

    • 使用项目级配置而不是全局配置
    • 定期更新远程仓库信息
    • 保持配置的一致性
  3. 安全性

    • 不要在仓库中存储敏感信息
    • 定期备份重要数据
    • 谨慎使用 force push

常见问题解决

  1. 仓库初始化失败

    • 检查目录权限
    • 确保 Git 正确安装
    • 验证用户配置
  2. 克隆失败

    • 检查网络连接
    • 验证仓库地址
    • 确认访问权限
  3. 远程仓库操作失败

    • 检查认证信息
    • 验证远程地址
    • 确认网络状态

练习

  1. 创建一个新的 Git 仓库并进行基本配置
  2. 克隆一个开源项目并查看其历史记录
  3. 添加远程仓库并推送本地更改
  4. 练习仓库的基本维护命令