做前端开发或者小程序项目，代码管理是绕不开的一环。很多人习惯用U盘或者微信传文件，结果改乱了根本找不回原版。把HBuilderX和Git结合起来，不仅能自动备份每一次修改，还能多人协作不冲突。这篇教程不讲复杂的底层原理，只讲在HBuilderX里怎么用Git，跟着步骤操作就能上手。
第一步安装Git环境并配置基础信息
HBuilderX本身没有内置Git，需要先在电脑上装好Git。去官网下载对应系统的安装包，一路默认安装就行。装完后打开命令提示符或者终端，输入git config --global user.name你的用户名然后回车，再输入git config --global user.email你的邮箱然后回车。这一步是为了告诉Git你提交代码时的身份标识。配完之后，HBuilderX就能识别本地的Git工具了。
第二步在项目中初始化Git仓库
打开HBuilderX，创建一个新项目或者直接打开现有的文件夹。点击顶部菜单栏的运行，找到运行到浏览器或者模拟器旁边的小箭头，往下拉能看到运行设置。在设置界面里切换到运行参数标签页，最下面有个勾选框叫启用Git版本控制，打上勾保存。接着回到项目根目录，右键点击项目名称，选择Git初始化。这时候项目文件夹里会多出一个隐藏的.git文件夹，说明仓库已经建好了。你可以看到左侧的源代码管理器面板，里面列出了所有待提交的文件。
第三步掌握日常提交与推送流程
写完代码后，先检查改动。在源代码管理器面板里，新增或修改过的文件前面会有红色标记。勾选你需要上传的文件，在下方输入框里写清楚这次改了什么，比如修复登录页样式错乱。点右上角的提交按钮，本地历史记录就存下来了。如果要把代码同步到GitHub或者Gitee，得先配置远程仓库地址。在项目根目录右键选择Git远程添加，填上你的仓库链接起名为origin。之后点击推送，输入账号密码或者令牌，代码就会安全传到云端。每次拉取新同事的代码时，直接点获取就行。
第四步处理分支管理与代码冲突
实际开发中经常要开新功能，不能直接在主干上乱改。在源代码管理器面板顶部点击新建分支按钮，起个名字像feature-login。切换过去后，你就可以放心测试新功能了。等测试通过，切回主分支，点击合并分支，选刚才那个功能分支，确认无误就合并进去了。最怕的是两个人改了同一个文件的同一行，系统会标红提示冲突。打开冲突文件，里面会有<<<<<<<和>>>>>>>这种分隔符，手动保留正确的代码段，删掉符号，重新提交一次就能解决。平时养成频繁小步提交的习惯，基本能避开大部分麻烦。
第五步常用快捷键与避坑建议
熟练后用键盘操作效率翻倍。Ctrl加Shift加C是快速提交，Ctrl加Shift加P是推送，Ctrl加Shift加G是拉取。这些组合键在面板里都能右键看到。新手容易犯的错误是忽略忽略列表。项目里的node_modules或者unpackage打包目录千万别提交，体积大还容易报错。在Git配置里把它们加到排除规则中。另外，不要跳过注释环节，每次提交都写人话，方便以后排查问题。视频里演示的只是基础操作，真正用起来还得靠日常项目练手。
把Git融入HBuilderX的工作流，能让你的开发过程更规范。不用再去纠结文件版本覆盖的问题，团队协作也能井井有条。按照上面的步骤一步步配置，坚持每天记录代码变更，几个月后你会发现自己对工程管理的理解上了一个大台阶。遇到具体报错时，把错误代码复制到搜索引擎，配合官方文档很快就能定位。保持动手练习，版本控制就不再是负担而是助力。
