将本地目录转为Git仓库并在GitHub初始化远程仓库的最优方法

一、自动创建GitHub远程仓库的方法 #

有官方工具可以实现这个需求——GitHub CLI（gh），它能直接在命令行完成远程仓库创建、关联本地仓库的全流程，步骤如下：

• 先安装gh工具（通过系统包管理器或GitHub官方渠道下载均可）
• 执行gh auth login完成账号登录验证
• 进入本地已有内容的目录，先完成本地仓库初始化：

  git init
  git add .
  git commit -m "Initial commit"
  

• 一键创建远程仓库并推送本地内容：

  # 创建公开仓库并推送
  gh repo create --source . --public --push
  # 创建私有仓库则用这条
  gh repo create --source . --private --push
  

这条命令会自动在你的GitHub账户下生成对应仓库，同时完成本地仓库与远程的关联、内容推送，省去网页手动创建的步骤。

二、避免使用git pull --allow-unrelated-histories的方案 #

你需要用到这个参数的核心原因是：手动创建远程仓库时勾选了初始化README、LICENSE或.gitignore文件，导致远程仓库已有独立的初始提交，和本地仓库的历史完全割裂。要规避这个问题，有两种可靠方法：

方案1：创建远程仓库时保持空状态 #

在GitHub网页创建仓库时，不要勾选「Add a README file」「Add .gitignore」「Choose a license」任何选项，让远程仓库完全为空。之后本地操作简化为：

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/OWNER/REPOSITORY.git
git branch -M main
git push -u origin main

全程无需执行pull，直接推送即可——因为远程仓库无任何历史，和本地初始提交自然形成关联。

方案2：已创建带初始文件的远程仓库时的补救方法 #

如果已经创建了带初始文件的远程仓库，不用强制合并历史，而是手动同步远程文件到本地：

1. 关联远程仓库：git remote add origin https://github.com/OWNER/REPOSITORY.git
2. 拉取远程仓库内容到本地：git fetch origin
3. 将远程的初始文件（如README.md）合并到本地分支：

   git checkout origin/main -- README.md LICENSE.md # 按需选择要同步的文件
   git add .
   git commit -m "Sync remote initial files"
   

4. 此时本地仓库历史已与远程关联，直接推送：git push -u origin main

内容的提问来源于stack exchange，提问作者worker1138