如何将本地未初始化的 Git 项目关联到已包含文件的远程仓库。主要步骤包括：初始化本地仓库、添加远程地址、使用--allow-unrelated-histories 参数拉取远程文件以解决历史无关冲突、配置.gitignore、暂存提交代码并最终推送到远程分支。同时提供了常见问题排查方法，如分支名错误和 Vim 编辑界面处理。
在日常开发中，经常遇到代码已在本地编写但文件夹中没有 .git 目录的情况。此时在 GitHub/Gitee/GitLab 上创建了一个新的远程仓库（可能已包含 README.md 或 .gitignore），需要将本地代码推送至该远程仓库并由 Git 管理。
本文将演示如何将本地现有文件夹与远程仓库关联，拉取远程文件，最后将本地项目完整提交的流程。
MyProject，里面有代码，但未执行过 git init。README.mdLICENSEMyProject 变成 Git 仓库，拉取远程的 README.md，然后把本地代码提交上去。进入本地项目文件夹，打开终端（Terminal 或 Git Bash）。
# 进入项目目录（请根据实际路径修改）
cd /path/to/your/MyProject
# 初始化 git 仓库
git init
执行完毕后，项目目录下会多出一个隐藏文件夹 .git，代表本地仓库已初始化完成。
使用 git remote add 命令将本地仓库与远程仓库建立连接。
# origin 是远程仓库的别名（习惯上默认叫 origin）
# <Your-Repository-URL> 换成你的仓库地址（HTTPS 或 SSH 均可）
git remote add origin https://gitee.com/username/my-project.git
如果远程仓库是空的，直接 Push 即可。但如果远程仓库里已经有文件，需要先把它 Pull 下来。
此时直接执行 git pull origin master 通常会报错：
fatal: refusing to merge unrelated histories（拒绝合并无关的历史）。
原因：本地仓库和远程仓库是两个独立生成的'历史'，Git 认为它们没有血缘关系，所以默认不让合并。
解决方案：加上 --allow-unrelated-histories 参数。
# 拉取远程代码，并允许合并无关历史
# 注意：此时分支名可能是 master 也可能是 main，请根据远程仓库实际情况调整
git pull origin master --allow-unrelated-histories
执行后，远程的 README.md 就会出现在你的本地文件夹中。
.gitignore（可选但推荐）在提交代码之前，建议在根目录下创建一个 .gitignore 文件，把不需要上传的文件（如 node_modules、.idea、*.log、dist 等）过滤掉。
如果没有这个文件，可以手动新建：
touch .gitignore
然后在里面写入你想忽略的文件或文件夹规则。
现在将本地的所有代码添加到暂存区，并提交到本地仓库。
# 将当前目录下所有更改添加到暂存区
git add .
# 提交到本地仓库，并附带注释
git commit -m "Initial commit: 将本地项目上传到远程仓库"
最后，将本地所有的提交推送到远程仓库。
# -u 表示将本地分支与远程分支关联，下次直接输入 git push 即可
# 同样注意分支名是 master 还是 main
git push -u origin master
整套流程的命令汇总如下（方便复制）：
# 1. 初始化
git init
# 2. 关联远程（替换你的地址）
git remote add origin https://your-repo-url.git
# 3. 拉取远程文件（关键：允许不相关历史合并）
git pull origin master --allow-unrelated-histories
# 4. 添加全部文件
git add .
# 5. 提交
git commit -m "init project"
# 6. 推送
git push -u origin master
报错 error: src refspec master does not match any
master（现在的 Git 版本可能默认叫 main）。git commit，然后检查当前分支名（git branch），如果是 main，则将命令中的 master 改为 main。Pull 的时候出现 Vim 编辑界面
i 进入编辑模式（可选，默认直接按 ESC 也可以）。ESC 退出编辑模式。:wq 然后回车（保存并退出）。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online