Git 本地仓库操作指南：将未提交文件复刻至新分支（无需关联远端）

在日常开发中，我们常会遇到这样的场景：本地仓库已有开发项目，存在未提交的修改内容，既不想将这些内容直接提交到当前分支，也无需上传至远端仓库，仅需在本地新建分支并将未提交文件完整复刻过去。此时可通过以下步骤高效完成操作，全程仅涉及本地仓库交互，无需依赖远端服务。

在进行分支操作前，首先需明确当前工作区和暂存区中未提交的文件详情，避免遗漏或误操作。打开终端，进入本地项目仓库目录，执行以下命令：

bash

lua 复制代码

git status

执行后终端会输出两类关键信息：

已修改但未暂存的文件 ：标注为 "modified: 文件名"，表示文件已修改但未通过git add加入暂存区；
未跟踪的文件：标注为 "untracked files: 文件名"，表示新创建的文件尚未被 Git 跟踪。通过该命令可清晰掌握需复刻的内容范围，确保后续操作针对性。

Git 的工作区和暂存区具有 "分支共享" 特性 ------ 未提交的修改不会与特定分支绑定，切换分支时会自动跟随到新分支。利用这一特性，我们可通过单条命令完成 "新建分支 + 切换分支"，同时保留未提交文件。

在终端执行以下命令：

bash

r 复制代码

git switch -c 新分支名称

命令解析：git switch用于切换分支，-c（全称 create）是 "新建分支" 的参数，紧跟的 "新分支名称" 需自定义（建议遵循项目命名规范，如feature/local-dev、fix/uncommitted-code）；
示例：若需新建名为local-copy-branch的分支，命令为git switch -c local-copy-branch。

执行成功后，终端会提示 "Switched to a new branch ' 新分支名称 '"，此时已切换至新分支，且第一步中确认的未提交文件（包括已修改未暂存、未跟踪文件）已完整保留在新分支的工作区 / 暂存区中。

切换到新分支后，需将未提交文件正式提交至新分支的本地仓库，确保这些内容被 Git 持久化跟踪（仅本地生效）。

根据需求选择暂存方式：

暂存后可再次执行git status验证，此时文件会标注为 "staged: 文件名"，表示已成功加入暂存区。

执行提交命令，为此次提交添加清晰的描述信息（便于后续查看提交历史）：

bash

sql 复制代码

git commit -m "提交说明：将原分支未提交文件复刻至新分支"

提交说明建议：需简洁明了，标注核心操作，如 "feat: 复刻原分支未提交的用户模块代码至 local-copy-branch"；
执行结果：终端会输出提交摘要，包括提交 ID、修改文件数量、新增 / 删除代码行数等，提示 "1 file changed, 2 insertions (+), 1 deletion (-)" 即表示提交成功。

至此，未提交文件已正式存储在新分支的本地仓库中，新分支具备完整的复刻内容。

若后续仍需在原分支开发，可切换回原分支，且原分支会保持创建新分支前的状态 ------ 即不包含新分支中提交的内容，确保原分支历史不被干扰。

执行切换命令：

bash

arduino 复制代码

git switch 原分支名称

若存在 "暂存区 + 工作区混合修改"（部分文件已git add，部分未暂存），切换分支后两种状态会完整保留，提交时需注意暂存区内容是否正确；
新分支名称避免与本地已存在的分支重名，若重名会提示 "fatal: A branch named ' 新分支名称 ' already exists"，需更换名称或删除原有分支（删除命令：git branch -d 分支名）；
若未提交内容中包含大型文件或敏感信息，无需担心泄露 ------ 全程本地操作，无任何内容上传至远端，安全性可控。

通过以上步骤，可在不依赖远端仓库的前提下，高效实现 "未提交文件本地分支复刻"，既保证了当前分支的纯净性，又能妥善保存未提交内容，适配本地临时开发、代码备份等场景需求。