背景

为了方便多端编辑、同步与溯源，采用 git 进行重要文档的管理

快速上手

创建远程仓库

在GitHub创建一个新的仓库：

登录您的GitHub账号，然后在GitHub上创建一个新的仓库。创建仓库时，GitHub会提供一个仓库的URL，看起来像这样：https://github.com/yourusername/your-repo-name.git。

生成个人访问令牌（PAT）：

• 登录你的GitHub账号。
• 转到设置（Settings）> 开发者设置（Developer settings）> 个人访问令牌（Personal access tokens）。
• 点击“生成新令牌”（Generate new token），选择所需的权限（对于推送操作，确保选中了repo），然后生成令牌。

使用PAT代替密码：

• 当命令行提示你输入用户名和密码时，用户名仍然是你的GitHub用户名，但密码处输入你刚刚生成的个人访问令牌。

创建本地仓库

初始化Git仓库：在项目目录中，运行git init命令来初始化一个新的Git仓库。这会创建一个名为.git的隐藏目录，其中包含了所有必要的Git仓库文件，但不会影响其他文件。

git init

创建.gitignore文件：使用touch .gitignore或nano .gitignore命令创建.gitignore文件，在文件内容中添加规则：

# macOS specific files
# macOS 特定文件
.DS_Store
.AppleDouble
.LSOverride

# Thumbnails cache files
# 缩略图缓存文件
._*
Thumbs.db
ehthumbs.db

# Folder config file (Windows)
# 文件夹配置文件 (Windows)
Desktop.ini

# Recycle Bin folder (Windows)
# 回收站文件夹 (Windows)
$RECYCLE.BIN/

# IDE and Editor specific files/folders
# IDE 和编辑器特定文件/文件夹
.idea/
.vscode/
*.suo
*.ntvs*
*.njsproj
*.sln.docstates
*.sublime-workspace
*.sublime-project

# Vim swap files and backups
# Vim 交换文件和备份文件
*.swp
*.swo
*~
*.bak
*.tmp

# Build output directories
# 构建输出目录
build/
dist/
out/
target/
bin/
obj/

# Dependency directories (very important for Node.js/npm/yarn/pnpm etc.)
# 依赖包目录 (非常重要，例如 Node.js/npm/yarn/pnpm 等项目的依赖)
node_modules/
bower_components/
jspm_packages/
vendor/

# Log files
# 日志文件
*.log
logs/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*

# Runtime data / Cache
# 运行时数据 / 缓存
.npm/
.yarn/cache
.yarn/plugnplay
.pnp.*
.pnpm-store/
__pycache__/
*.pyc
*.pyo
*.class

# Environment variables file (NEVER commit secrets!)
# 环境变量文件 (切勿提交敏感信息!)
.env
.env.*
# You might want to keep example/template files
# 但你可能想要保留示例或模板文件
!.env.example
!.env.template

# OS generated files
# 操作系统生成的文件
.config
*.stackdump

# Temporary files
# 临时文件
*.tmp
*.temp

# Compressed files (uncomment if you don't want archives in repo)
# 压缩文件 (如果不想将存档文件加入仓库，请取消注释)
# *.zip
# *.tar.gz
# *.rar

添加文件到暂存区：使用git add命令来添加文件到Git暂存区。如果你想添加当前目录下的所有文件（不包括.gitignore中指定的文件），可以使用.代表当前目录：

git add .

这一步将当前目录下的所有文件和子目录添加到暂存区，准备进行提交。

提交文件到仓库：使用git commit命令来将暂存区的文件提交到仓库。你需要提供一个提交消息，描述这次提交的内容。这可以通过-m选项后面跟上消息内容来实现：

git commit -m "Initial commit"

这一步将暂存区的更改永久记录到Git历史中。

将远程仓库添加到您的本地仓库：

使用GitHub提供的仓库URL将远程仓库添加为origin：

git remote add origin https://github.com/yourusername/your-repo-name.git

推送本地更改到GitHub：

将您的更改推送到GitHub仓库：

git push -u origin main

系统会提示你输入账号和PAT

拉取远程仓库并修改

cd到本地仓库根目录，然后运行以下命令以从GitHub拉取最新更改：

git pull origin master

本地修改完毕后

git add -A
git commit -m "Update"

推送到远程仓库

git push origin main

疑难杂症

出现.DS_Store文件怎么办

如果.DS_Store文件已经被提交并推送到了远程仓库中，你可以使用以下命令来查找并删除所有的.DS_Store文件

find . -name .DS_Store -print0 | xargs -0 git rm -f --ignore-unmatch

这个命令会查找当前目录及其子目录中的所有.DS_Store文件，并使用git rm命令将它们从Git中删除。

提交并推送

git commit -m "Remove .DS_Store files"

git push origin main

git出现分支怎么办？

方案一：合并（Merge）

合并是将远程分支的更改和你的本地分支更改合并在一起的方法。它会创建一个新的“合并提交”来表示这个合并。如果你想使用合并，可以设置 Git 以合并模式拉取：

git config pull.rebase false
git pull origin main

这将会创建一个合并提交，如果有冲突，你需要手动解决它们。

方案二：变基（Rebase）

变基是另一种解决分叉的方法，它会把你本地分支上的提交重新应用到远程分支的最新提交之上。这样做的好处是可以保持项目历史更线性。

git config pull.rebase true
git pull origin main

如果在变基过程中遇到冲突，你需要解决这些冲突，并继续变基过程。

每个目录下都有.DS_Store文件

.DS_Store文件是macOS特有的一个文件，它存储了其所在文件夹的自定义属性，如文件夹视图选项、图标位置以及其他视觉信息。.DS_Store是“Desktop Services Store”的缩写，反映了它的用途。这个文件由Finder应用程序在每个文件夹中创建和维护，其功能类似于Windows系统中的desktop.ini文件 。

为了防止这些文件被提交到版本控制系统，你可以将.DS_Store添加到.gitignore文件中，以便忽略它们。

如果在你执行git push之后，远程仓库中的.DS_Store文件依然存在，那么很可能是因为这些文件已经被提交并推送到了远程仓库中，在你将.DS_Store添加到.gitignore之后。.gitignore文件只会忽略尚未跟踪的文件，对于已经被Git跟踪的文件，即使后来被添加到.gitignore中，它们也不会自动从版本控制中删除。

为了删除远程仓库中的.DS_Store文件，你需要先在本地仓库中删除这些文件，提交这个更改，然后再次推送到远程仓库。以下是具体步骤：

1. 删除本地仓库的.DS_Store文件

首先，你可以在命令行中使用以下命令来查找并删除所有的.DS_Store文件：

find . -name .DS_Store -print0 | xargs -0 git rm -f --ignore-unmatch

这个命令会查找当前目录及其子目录中的所有.DS_Store文件，并使用git rm命令将它们从Git中删除。

2. 提交更改

删除文件后，你需要提交这个更改：

git commit -m "Remove .DS_Store files"

3. 推送到远程仓库

最后，使用git push命令将这些更改推送到远程仓库：

git push origin main

请确保将main替换为你正在使用的分支的名称，如果是master分支则相应替换为master。

这样操作后，.DS_Store文件就会从远程仓库中删除，而.gitignore文件会阻止这些文件将来被再次添加。不过，请记住，如果其他贡献者的本地仓库中仍然存在.DS_Store文件，并且他们没有在本地配置相应的.gitignore，那么这些文件可能会再次被推送到远程仓库中。分享.gitignore配置和确保团队成员了解如何使用它，可以帮助避免这种情况的发生。