git功能需手动安装easy git插件才启用；验证方式有三：菜单栏出现“工具→git”、项目管理器右键含git子项、编辑器右下角显示分支名及↓↑√图标；提交前必须先暂存文件，否则点√无反应；拉取失败多因本地未提交修改，须先提交或stash，冲突时需手动解决。
Git 功能默认不启用，必须先装 Easy Git 插件；没装插件时点任何 Git 按钮都无效，不是卡顿也不是配置错。
怎么确认 Git 插件已安装并生效
Easy Git 不是 HBuilder X 自带组件，首次使用必须手动安装。装完后不会自动弹窗提示，得靠三个地方验证：
- 顶部菜单栏出现
工具 → Git选项（没装时这里只有“插件安装”） - 项目管理器右键菜单里有
Git子项（含“提交”“分支”“远程”等） - 编辑器右下角状态栏显示分支名 +
↓↑√图标（没装时只显示文件编码或行号）
Windows 用户如果右键菜单缺 Git 项，除了装 Easy Git，还可额外装 TortoiseGit 补充右键功能，但非必需。
提交代码前必须暂存（Stage），直接点 √ 不等于 commit
HBuilder X 的提交流程是两步：先暂存变更文件，再输入信息提交。很多人点右下角 √ 没反应，其实是漏了暂存这步。
- 打开左侧
源代码管理视图，所有修改过的文件列在“更改”区 - 每个文件旁有
+号，点它才把该文件加入暂存区；也可点顶部+ 暂存所有更改 - 只有暂存后的文件才会出现在提交对话框里，未暂存的改了也白改
- 提交信息框右侧的
√是真正执行git commit，不是“确认输入”
命令行等价操作是：git add . → git commit -m "xxx"。跳过 git add 直接 git commit -a 在图形界面里不支持。
拉取（Pull）失败常见于本地有未提交修改
点 ↓ 图标或菜单里的“拉取”报错 “Please commit your changes or stash them”，不是网络问题，是 Git 保护机制。
- Git 不允许在工作区有未提交变更时直接合并远程更新，怕覆盖你的改动
- 解决方式只有两个：要么先
提交这些修改，要么用命令行git stash临时存起来（图形界面不提供 stash 功能） - 如果只是想丢弃本地修改，右键文件选
Git → 还原，比删文件重拉安全 - 拉取后若提示“自动合并失败”，说明已进入冲突状态，别急着关窗口，先看下一步
冲突文件里看到
冲突不是错误，是 Git 把两版修改都保留在文件里让你选。HBuilder X 不会帮你合并，只负责标出位置。
- 冲突块长这样：
（你本地改的）、<code>=======（分隔线）、>>>>>> origin/main（远程改的） - 必须手动删掉这三行标记，并保留最终要的代码——只留一版，或揉成新版，不能留着标记提交
- 改完保存后，回到
源代码管理视图，该文件会从“冲突”移到“更改”区，这时要点+暂存，再√提交 - 如果忘了暂存就关了编辑器，下次打开时文件仍标为冲突，得重新处理
多人协作时最容易忽略的是：切换分支前必须清空工作区，哪怕只是改了一行 CSS，否则检出失败且不报具体原因。
