[测试工具] 如何把离线的项目加入成为git项目的新分支

*原创内容，未获授权禁止转载、转发、抄袭。

工作中遇到某天下载了一个内部工具代码，后来间歇性改了些代码，想在合并到git中，做一下记录：

🔧1. 准备本地 Git 仓库

首先，需要确保你的离线项目目录已经是一个 Git 仓库。

• ​​如果项目目录还不是 Git 仓库​​：请在终端中进入你的项目根目录，然后执行以下命令进行初始化：

git init

• ​​如果已经是 Git 仓库​​：这一步可以跳过

🔗 2. 关联远程仓库

接下来，将你的本地仓库与已有的远程仓库关联起来。将下面命令中的 <远程仓库URL>替换为你实际项目的 URL。

git remote add origin <远程仓库URL>

例如：git remote add origin https://github.com/username/repository.git。执行后，可以使用 git remote -v命令来确认远程仓库是否添加成功

🌿 3. 创建并切换到新分支

在本地创建一个新的分支，并立即切换到这个新分支上工作。将 <新分支名称>替换为你打算创建的分支名。

git checkout -b <新分支名称>

这个命令等价于先执行 git branch <新分支名称>创建分支，再执行 git checkout <新分支名称>切换分

➕ 4. 添加并提交文件

将你离线项目中的所有文件添加到 Git 的暂存区，然后提交到本地仓库。

• 添加文件到暂存区：

git add .

• 将暂存区的文件提交到本地仓库，并附上提交信息：

git commit -m "描述本次提交的信息"

例如：git commit -m "首次提交离线项目文件"

⬆️ 5. 推送到远程新分支

最后，将本地新分支的提交推送到远程仓库。如果远程仓库还不存在同名分支，Git 会自动创建它

git push -u origin <新分支名称>

这里的 -u(或 --set-upstream) 参数会将本地的 <新分支名称>分支与远程的同名分支建立关联，这样以后在这个分支上直接使用 git push即可

💡 重要提示

• ​​分支命名​​：建议分支名简单明了，使用短横线（如 my-new-feature）而非空格进行分隔。
• ​​权限检查​​：确保你对远程仓库有写入权限，才能成功推送。
• 处理冲突​​：如果远程仓库的目标分支已有其他人更新的内容，建议先执行 git pull origin <新分支名称>拉取最新更改并解决可能的合并冲突后再推送。

后续修改代码后提交：

步骤	核心命令	关键说明
​​1. 检查修改​​	git status	查看哪些文件被修改、新增或删除，确认本次要提交的内容。
​​2. 暂存更改​​	git add <文件名>或 git add .	将文件的修改添加到暂存区，准备本次提交。
​​3. 提交到本地仓库​​	git commit -m "提交信息"	将暂存区的更改正式提交到本地仓库，提交信息务必清晰。
​​4. 推送到远程仓库​​	git push origin <分支名>	将本地提交同步到远程仓库（如GitHub），完成整个流程。