开发实践

使用 Git 工作台

检查文件和选中行的差异,核对提交,再处理分支、同步、冲突和恢复。

需要在 Code 工作区管理版本的开发者约 9 分钟阅读
操作入口
Code 项目 → 底部 Git 状态栏「变更」→ Git 工作台
完成结果
提交内容与预览一致,能区分本地提交和远程推送,并找到冲突与恢复入口。
本篇目录

1. 打开并确认仓库

  1. 在 Code 中打开正确项目,点击底部 Git 状态栏的「变更」进入工作台,核对仓库路径、当前分支和未提交文件。协同时同时核对执行电脑。
  2. 项目尚未使用 Git 时,按页面选择初始化当前目录、打开已有仓库或从远程克隆。克隆目标目录必须为空。
  3. 初始化时核对初始分支、提交姓名、邮箱和忽略规则。初始化、首次提交和推送分别操作。
  4. 私有仓库按提示使用 HTTPS Token 或 SSH 密钥。首次 SSH 连接先向仓库管理员核对主机指纹,再决定是否信任。

2. 按文件或修改行选择内容

  1. 在「变更」中分别查看未暂存、已暂存文件,选择文件阅读差异。需要调整时在差异编辑器修改并保存。
  2. 整文件提交时选择对应文件;只提交部分修改时,选中需要的修改行并使用「暂存选中行」。
  3. 再次检查已暂存差异,确认调试内容、凭据和其他任务的修改没有混入本次提交。
  4. 出现手动稿或磁盘变化提示时,先处理保存与合并;文件已经变化的选行需要重新选择。

3. 检查与预览后提交

本地提交成功与推送成功分别显示。如果提示“提交已完成,推送未完成”,保留已完成的提交,处理认证或远程目标后重试推送,无需再次提交相同改动。

  1. 填写能说明问题和改动的提交说明,核对本次选择的文件与行。
  2. 按工作台提示保存手动稿,运行提交检查并阅读结果;构建或测试失败时先处理真实失败原因。
  3. 查看提交预览,核对分支、提交范围和内容后确认。预览后分支或 HEAD 变化,需要重新审查。
  4. 提交完成后在「历史」核对新提交和文件差异。需要发布时进入「同步」,确认远程仓库、分支和上游后再推送。

4. 管理分支、标签与远程同步

「分支」用于创建、检出、合并、变基及标签操作;其余入口收在「更多 Git 功能」。

4. 管理分支、标签与远程同步参考表
入口操作与核对重点
历史按提交说明、哈希、作者、文件或分支定位记录,选择提交查看版本差异。
同步Fetch 获取引用;Pull 按 Merge 或 Rebase 策略更新当前分支;Push 发布本地提交。
远程仓库维护远程名称、获取与推送地址;默认推送远程和分支上游分别核对。
Stash暂存工作进度,恢复时区分应用并保留、应用并移除。
Worktree为独立工作目录管理工作树,操作前确认目录和分支归属。
高级按需要操作补丁、子模块、Git LFS 等;依赖当前执行环境和对应仓库权限。

5. 解决冲突并核对恢复结果

  1. 合并、变基等操作出现冲突时,打开冲突入口,逐文件查看三方内容并编辑最终结果。
  2. 保存结果、清除冲突标记并标记已解决;所有冲突处理完成后,使用页面的「继续」完成原操作。
  3. 需要放弃本次合并或变基时使用对应「中止」入口,核对将恢复的状态。跳过提交会排除该提交的修改,应先确认。
  4. 误操作时进入「操作与恢复」查看恢复点与 Reflog,先核对恢复范围,再执行恢复和项目验证。
  • 克隆认证失败:补充当前目标所需凭据再重试,核对协议、主机与端口。
  • 拉取或变基提示本地文件阻塞:保留现有文件并按提示处理,不直接删除忽略文件绕过保护。
  • 保存冲突或差异变化:重新读取磁盘状态,解决手动稿冲突后再提交。
  • 恢复完成后检查文件和 Git 状态;本地恢复不会自动撤销已推送或外部系统中的操作。