GitHub与Git命令使用笔记

---

上传本地的新项目到github

1. 创建新的GitHub仓库

1. 在GitHub的首页或任意页面，点击右上角的"+“，然后选择"New repository”。
2. 填写仓库的基本信息：
   • Repository name：仓库名称。
   • Description（可选）：仓库描述。
   • Visibility：选择仓库的可见性（公开或私有）。
   • 根据需要选择其他选项，如初始化README文件、添加.gitignore或选择许可证。
3. 点击"Create repository"。

.gitignore是什么：用于指定在版本控制过程中Git应该忽略的文件和目录

.gitignore示例：

# 忽略所有.log结尾的文件
*.log

# 忽略临时文件，以~结尾
*~

# 忽略特定目录下的所有文件（例如，node_modules）
node_modules/

# 忽略特定的文件（例如，config.env）
config.env

# 忽略所有.DS_Store（Mac系统文件）
.DS_Store

# 忽略所有生成的二进制文件，例如Java编译产生的.class文件
*.class

# 忽略打包文件
*.jar

# 对于Python项目，忽略虚拟环境目录
venv/
.env/

# 忽略编译生成的文件
/bin/
/obj/
/build/

# 忽略IDE设置文件和文件夹，如IntelliJ IDEA和VSCode
.idea/
.vscode/

# 忽略特定前缀的文件，例如所有以tmp开头的文件
tmp*

# 不忽略特定文件（即使前面的规则匹配了它）
# 使用感叹号'!'来表示不忽略
!important.log

# 忽略特定文件夹下除某个文件外的所有文件
/somefolder/*
!/somefolder/keepme.txt

2. 初始化本地项目目录

在本地项目目录中打开终端或命令提示符，执行以下命令：

1. 初始化Git仓库：

   git init
   

   这将在项目目录中创建一个新的git仓库。

2. 添加文件到Git仓库：
   首先，可以使用git add命令来添加文件到仓库中，例如：

   git add .
   

   这个命令会添加当前目录下的所有文件到仓库中。如果只想添加特定文件，可以将.替换为具体的文件名。

3. 提交更改：
   使用以下命令来提交这些更改到仓库：

   git commit -m "Initial commit"
   

   其中"Initial commit"是提交消息，可以根据实际更改内容自定义这个消息。

3. 将本地仓库关联到GitHub

使用在GitHub创建仓库时得到的URL将本地仓库关联到GitHub上。这个URL可以在仓库页面的"Quick setup"部分找到。执行以下命令，将<your-repository-URL>替换为实际的URL：

git remote add origin <your-repository-URL>

4. 推送本地代码到GitHub

最后，使用以下命令将本地代码推送到GitHub仓库：

git push -u origin main

这样，就成功地将本地的新项目上传到了GitHub。在未来，每当完成了一系列更改并希望将这些更改推送到GitHub时，只需要重复上面的git add、git commit和git push步骤。

上传本地项目到GitHub时发生冲突

将默认分支名称从master改为main

将默认分支名称从master改为main，可以按照以下步骤操作：

1. 全局更改默认分支名称（可选）：

   git config --global init.defaultBranch main
   

2. 更改当前仓库的分支名称：

   git branch -m main
   

我不想提交我的更改，我想直接从main中拉下来覆盖本地代码

1. 重置本地分支：

   这将重置你本地的代码，直接将其回退到远程版本的状态。注意，这样做会丢失你本地所有未提交的更改。

   git fetch origin main
   git reset --hard origin/main
   

2. 确认修改后的状态：

   你可以通过 git status 来确认你的代码状态是否已经恢复到远程仓库的最新状态。

   git status
   

完整步骤：

git fetch origin main
git reset --hard origin/main
git status

这会丢失所有未提交的更改，确保已经备份了重要的代码或数据。

git 把远程项目拉到本地，并和本地项目合并

要将远程项目拉取到本地并与现有的本地项目合并，可以遵循以下步骤。这些步骤假设已经有一个本地项目和一个远程仓库，并且希望将远程仓库的内容合并到本地项目中。

1. 在本地项目中添加远程仓库

首先，需要在本地项目中添加远程仓库（如果尚未添加）。打开终端或命令提示符，然后导航到的本地项目目录。使用以下命令添加远程仓库（将<remote-repo-url>替换为你的远程仓库URL）：

git remote add origin <remote-repo-url>

这里，origin是远程仓库的默认名称，但你可以选择任何名称。

2. 拉取远程仓库的内容

使用以下命令从远程仓库拉取最新的内容：

git fetch origin

3. 检查远程分支

在合并之前，你可能想要检查远程仓库中有哪些分支：

git branch -r

4. 切换到你想合并的分支

如果你还没有本地分支对应于远程分支，你可以使用以下命令创建并切换到一个新的本地分支，这个分支会跟踪远程分支（将<branch-name>替换为想要合并的分支名）：

git checkout -b <branch-name> origin/<branch-name>

如果已经有了一个本地分支并希望将远程分支的变更合并到这个本地分支中，确保现在就在那个本地分支上。如果不是，使用git checkout <branch-name>切换到那个分支。

5. 合并远程分支

现在，使用以下命令将远程分支的变更合并到你的当前本地分支：

git merge origin/<branch-name>

如果本地的更改是有效的，需要合并处理冲突

如果在合并过程中遇到任何冲突，Git将提示你解决这些冲突。可以手动编辑冲突文件，然后使用git add <file>来标记它们已解决。

这个错误信息表明在尝试合并origin/main分支到你的当前分支时，存在一些未提交的更改。这些本地更改在合并操作中可能会被覆盖，因此Git阻止了合并操作以防止可能的数据丢失。

要解决这个问题，你有几个选项：

1. 提交更改

如果你想保留这些更改，你应该先提交它们。这可以通过以下命令完成：

git add .
git commit -m "描述你的更改"

然后，你可以再次尝试合并：

git merge origin/main

2. 贮藏更改

如果你现在不想提交这些更改，但希望稍后再处理，你可以使用贮藏（stash）功能将更改临时保存起来。这可以通过以下命令完成：

git stash

然后，你可以再次尝试合并：

git merge origin/main

合并完成后，如果你想重新应用之前贮藏的更改，可以使用：

git stash pop

3. 放弃本地更改

如果你确定不再需要这些本地更改，你可以使用以下命令放弃它们：

git checkout -- <file>

将<file>替换为你想放弃更改的文件名，或者如果你想放弃所有未提交的更改，可以使用：

git reset --hard

注意：git reset --hard会放弃所有未提交的更改，并且这些更改无法恢复，请谨慎使用。

选择适合你情况的方法处理本地更改后，你应该就能成功合并origin/main分支了。

6. 推送合并更改

如果你对本地分支进行了更改，并希望将合并后的更改推送到远程仓库，使用以下命令：

git push origin <branch-name>

git clone 特定提交版本的项目（不是最新版本）

要克隆Git仓库的特定提交版本，需要先克隆整个仓库，然后切换到那个特定的提交。Git不允许直接克隆特定的提交，但以下步骤可以帮助你达到目的：

1. 克隆仓库：首先，克隆整个仓库到本地。需要仓库的URL。使用以下命令克隆仓库：

git clone <repository-url>

把<repository-url>替换成想克隆的仓库的URL。

2. 查找提交ID：然后，需要找到你想要检出的特定提交的ID（也称为哈希值）。如果你已经知道这个提交ID，你可以跳过这一步。否则，进入仓库目录，然后使用git log查看提交历史：

cd <repository-name>
git log

在这里，<repository-name>是仓库目录的名称。使用git log命令，你可以看到每个提交的详细信息，包括提交ID。找到你想要检出的那个提交的ID。

3. 检出到特定提交：一旦你找到了提交ID，就可以使用git checkout命令检出到那个特定的提交：

git checkout <commit-id>

将<commit-id>替换为你在上一步找到的提交ID。

这将会使工作目录处于"分离HEAD"状态，意味着你不在任何分支上。这是因为你检出的是一个特定的提交，而不是分支的最新提交。如果你想在这个状态下开始一个新的分支，可以使用以下命令：

git checkout -b <new-branch-name>

将<new-branch-name>替换为你想要创建的新分支的名称。

这样，就可以在特定的提交版本上开始工作了，无论是为了审查旧代码、进行实验性开发，还是其他任何原因。

把gitignore里记录的文件类型排除在外，生成该目录下的文件结构tree

git ls-tree -r HEAD --name-only | tree --fromfile

设置.gitignore里需要忽略的文件夹中的内容

不想将 chat_log/ 文件夹中的内容提交到 Git 仓库中，可以将该文件夹添加到 .gitignore 文件中。.gitignore 文件用于指定未跟踪的文件，Git 将忽略这些文件，不会将它们包含在版本控制中。以下是如何做的步骤：

1. 在你的仓库根目录下创建或编辑 .gitignore 文件：
   如果 .gitignore 文件已经存在，直接编辑它；如果不存在，你需要创建一个新的 .gitignore 文件。

2. 添加规则以排除 chat_log 文件夹：
   打开 .gitignore 文件，在文件中添加以下行：

   chat_log/
   

   这行指令告诉 Git 忽略 chat_log 文件夹下的所有内容。

3. 保存并关闭 .gitignore 文件。

4. 将 .gitignore 文件提交到你的仓库：
   首先，你需要添加 .gitignore 文件到 Git：

   git add .gitignore
   

   然后，提交更改：

   git commit -m "Add .gitignore to exclude chat_log directory"
   

   最后，推送更改到远程仓库：

   git push
   

5. 清理已跟踪的 chat_log 文件夹（可选）：
   如果 chat_log 文件夹已经被跟踪（即已经被添加到仓库中），你可以使用以下命令来从 Git 仓库中移除它，同时保留文件系统中的文件：

   git rm -r --cached chat_log/
   git commit -m "Remove chat_log directory from repository"
   git push
   

   这将删除仓库中对 chat_log 文件夹的跟踪，但不会从你的本地文件系统中删除这些文件。

通过这些步骤，可以确保 chat_log 文件夹中的文件不会被 Git 跟踪或提交。