# git-repository-management

**Repository Path**: fgjv/git-repository-management

## Basic Information

- **Project Name**: git-repository-management
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git管理仓库方法

###  git常用命令

1. git init ： 初始化仓库

2. git remote add origin(仓库名) 选程仓库的地址 : 让本地仓库与选程仓库进行绑定，origin是仓库名

   > 上述两条命令一般只执行一次

3. git add . : 把工作区修改的文件添加到暂存区

4. git commit -m '可变提示语' : 把暂存区的内容提交到本地仓库

5. git push -u origin(仓库名) master(分支名) : 把本地仓库的内容上传到origin仓库下面的master分支

6. git pull [仓库名 分支名] :把选程仓库的内容下拉到本地仓库

7. git status : 查看变化

8. git branch : 查看分支

9. git branch 分支名 ：创建分支

10. git checkout 分支名：切换分支



### 简易的命令行入门教程:

Git 全局设置:

```
git config --global user.name "12付久亮"
git config --global user.email "2085268823@qq.com"
```

创建 git 仓库:

```
mkdir git-repository-management
cd git-repository-management
git init 
touch README.md
git add README.md
git commit -m "first commit"
git remote add origin https://gitee.com/fgjv/git-repository-management.git
git push -u origin "master"
```

已有仓库?

```
cd existing_git_repo
git remote add origin https://gitee.com/fgjv/git-repository-management.git
git push -u origin "master"
```



https://gitee.com/fgjv/git-repository-management.git

### 1. 准备工作

首先确保已安装 Git 并注册码云账号：

- 安装 Git：[Git 官网下载](https://git-scm.com/downloads)
- 注册码云：[Gitee 官网](https://gitee.com/)

### 2. 配置 Git 身份

首次使用 Git 需要配置用户名和邮箱（与码云账号一致）：

```bash
git config --global user.name "你的码云用户名"
git config --global user.email "你的码云注册邮箱"
```

### 3. 两种仓库管理方式

方式一：从本地项目初始化并关联码云

```bash
# 1. 进入本地项目目录
cd /path/to/your/project

# 2. 初始化 Git 仓库
git init

# 3. 添加所有文件到暂存区
git add .

# 4. 提交到本地仓库
git commit -m "初始化项目"

# 5. 在码云创建新仓库（获取仓库地址，如：https://gitee.com/用户名/仓库名.git）

# 6. 关联远程仓库
git remote add origin https://gitee.com/用户名/仓库名.git

# 7. 推送到码云（首次推送需要 -u 参数）
git push -u origin master  # 若使用 main 分支则替换为 main
```

方式二：克隆码云已有仓库到本地

```bash
# 克隆仓库
git clone https://gitee.com/用户名/仓库名.git

# 进入克隆的项目目录
cd 仓库名
```

### 4. 日常开发常用操作

1. 拉取远程最新代码

   ```bash
   git pull origin 分支名  # 如 git pull origin master
   
   ```

2. 提交本地修改

   ```bash
   # 查看修改状态
   git status
   
   # 添加指定文件到暂存区
   git add 文件名
   
   # 添加所有修改到暂存区
   git add .
   
   # 提交到本地仓库
   git commit -m "提交说明：如修复了XX bug"
   
   # 推送到远程仓库
   git push origin 分支名
   ```

   

3. 分支管理

   ```bash
   # 查看所有分支（本地+远程）
   git branch -a
   
   # 创建新分支
   git checkout -b 新分支名
   
   # 切换到已有分支
   git checkout 分支名
   
   # 推送新分支到远程
   git push -u origin 新分支名
   
   # 合并分支（如将dev分支合并到master）
   git checkout master
   git merge dev
   ```

   

4. 版本回退

   ```bash
   # 查看提交历史
   git log  # 详细日志
   git log --oneline  # 简洁日志
   
   # 回退到指定版本
   git reset --hard 提交ID  # 提交ID可从log中获取
   
   # 强制推送到远程（谨慎使用，会覆盖远程历史）
   git push -f origin 分支名
   ```

   

5. 忽略文件

   在项目根目录创建 `.gitignore` 文件，添加不需要跟踪的文件 / 目录：

   ```plaintext
   # 示例：Python项目
   __pycache__/
   *.pyc
   *.pyo
   venv/
   .env
   ```

   

### 5. 协作开发注意事项

1. 多人协作时，建议使用分支开发模式（如 `master` 主分支，`dev` 开发分支，`feature/*` 功能分支）
2. 提交前先 `pull` 获取最新代码，避免冲突
3. 遇到冲突时，手动编辑冲突文件后重新提交
4. 重要操作（如合并、回退）前建议备份代码

这些命令基本能满足日常使用码云仓库的需求，根据实际场景可以灵活组合使用。



----



# git报错

## 代码提交时出现master-hook-declined错误

你在向码云（Gitee）推送代码到 `master` 分支时被拒绝了，错误提示为 `hook declined to update refs/heads/master`，这通常是由于码云仓库设置了保护规则或钩子程序阻止了推送操作。

```bash
remote: Powered by GITEE.COM [1.1.23]
remote: Set trace flag 0e4d18a3
remote: Push will publish a hidden email, make email public or abandon related commits
remote: error: hook declined to update refs/heads/master
To https://gitee.com/fgjv/git-repository-management.git
 ! [remote rejected] master -> master (hook declined)
error: failed to push some refs to 'https://gitee.com/fgjv/git-repository-management.git'
```



### 可能的原因及解决方法：

- 错误信息中提到 `Push will publish a hidden email`，可能是因为你的提交中包含了未公开的邮箱
- 解决：

  - 在码云个人设置中，将邮箱设置为公开，或取消勾选  **“禁止命令行推送”**  的选项（「个人设置」→「邮箱管理」）
  - ![邮箱设置](./images/邮箱设置.png)