详细讲解了在 Windows 系统下配置 HBuilderX 与 Git 的步骤，包括 Git 安装、用户身份设置、IDE 路径关联及项目初始化。内容涵盖日常协作命令（Add/Commit/Push/Pull）、分支管理策略以及 .gitignore、SSH 密钥、换行符处理等最佳实践，旨在帮助 uni-app 开发者建立规范的版本控制流程，提升团队协作效率。
在现代前端和跨平台开发中，尤其是在使用 HBuilderX 开发 uni-app、小程序这类项目时，能否顺畅地与团队共享代码、安全地管理变更，直接决定了项目的推进效率。而这一切的核心，就是 Git 的正确配置与集成。
本文将带你一步步完成 Windows 环境下 HBuilderX 与 Git 的完整整合 ，不仅告诉你'怎么点'，更讲清楚'为什么这么配'。最终目标是：让你在一个熟悉的 IDE 里，安心编码、自信提交、高效协作。
HBuilderX 是国内开发者非常熟悉的一款轻量级但功能强大的 IDE，尤其适合 Vue、uni-app 和 HTML5 项目。它的一大优势就是'开箱即用'的体验感强——但很多人忽略了它内置的 Git 图形化支持。
而 Git，则是目前最主流的分布式版本控制系统。它的强大之处在于：
把两者结合起来，意味着你可以： ✅ 不离开 HBuilderX 就完成日常提交 ✅ 用鼠标点击代替记忆复杂命令 ✅ 实时看到文件状态变化（红/绿/灰） ✅ 安全对接 GitHub、Gitee、GitLab 等平台
接下来，我们就从头开始，一步一步构建这个高效协作的基础环境。
前往官网下载 Git for Windows：https://git-scm.com/download/win
下载后运行安装程序，大部分选项保持默认即可，但以下几项建议特别注意：
| 安装步骤 | 推荐选择 |
|---|---|
| 默认编辑器 | Vim 或 Nano（也可选 VS Code） |
| PATH 环境变量 | ✅ Use Git from Windows Command Prompt （确保全局可用） |
| SSH 客户端 | 使用内置 OpenSSH |
| 换行符处理 | ✅ Checkout as-is, commit Unix-style line endings （推荐，利于跨平台） |
📌 提示：如果你未来主要使用 Gitee/GitHub，且希望免密登录，记得启用 SSH 支持。
安装完成后，打开任意终端（命令提示符或 Git Bash），输入：
git --version
如果输出类似 git version 2.40.1.windows.1，说明安装成功。
Git 要求每个提交者都必须有唯一标识。请立即设置你的用户名和邮箱：
git config --global user.name "张三"
git config --global user.email "[email protected]"
⚠️ 注意：这里的邮箱最好与你在 Gitee/GitHub 上注册的一致，否则提交记录可能无法关联到你的账号。
你可以通过以下命令查看当前配置：
git config --list
确认 user.name 和 user.email 已正确写入。
很多初学者卡住的第一关是：'为什么 HBuilderX 显示'未找到 Git'？' 答案很简单：IDE 不知道 git.exe 在哪。
git.exe。常见的路径包括：
C:\Program Files\Git\cmd\git.exe
C:\Users\{你的用户名}\AppData\Local\Programs\Git\cmd\git.exe
💡 小技巧：不确定路径在哪？可以在开始菜单搜索 'Git Bash'，右键 → 属性 → 查看'目标'中的路径，去掉
"C:\Program Files\Git\bin\bash.exe"后半部分，替换为cmd\git.exe即可。
填写完成后，重启 HBuilderX 或刷新 Git 面板测试。
点击右侧的【Git】图标，或使用快捷键 Ctrl + Shift + G，打开 Git 面板。
此时如果没有报错，并显示'暂无提交记录'之类的提示，说明 Git 已成功集成。
对于全新项目，你需要先创建一个本地 Git 仓库：
.git 文件夹（隐藏）；接着就可以进行首次提交了。
假设团队已在 Gitee 创建了空仓库，地址为：
https://gitee.com/teamname/project.git
你只需在 HBuilderX 中操作：
git clone。✅ 实践建议：优先使用 SSH 协议 克隆，避免频繁输入账号密码。例如：
[email protected]:teamname/project.git
我们稍后会详细介绍如何配置 SSH 密钥。
当你进入正常开发节奏后，每天大概率要做这四件事：
修改文件后，文件名变为红色 —— 表示工作区已变更。
在 Git 面板中勾选需要提交的文件，点击【添加到暂存区】，颜色变绿，表示已进入暂存区。
等效命令：
git add .
点击【提交】按钮，弹出输入框，填入提交信息，如：
feat: 添加用户登录页面 fix: 修复表单校验逻辑错误 docs: 更新 README 使用说明
📌 建议采用 语义化提交规范（conventional commits），便于后期自动生成 changelog。
等效命令：
git commit -m "feat: 添加用户登录页面"
提交只是保存在本地仓库，要想让队友看到，必须推送至远程：
点击【推送】按钮，HBuilderX 执行：
git push origin main
如果是第一次推送，系统可能会提示设置上游分支，按提示确认即可。
别人提交了新代码，你要同步进来：
点击【拉取】按钮，等效于：
git pull origin main
⚠️ 重要提醒：务必在拉取前提交或暂存自己的修改！否则 Git 可能自动合并失败，导致冲突甚至代码丢失。
直接在 main 分支上开发风险极高。正确的做法是：为每个功能或修复创建独立分支。
比如你要开发'登录弹窗'，可以新建分支：
git checkout -b feature/login-modal
在 HBuilderX 中操作方式如下：
main）；feature/login-modal；开发完成后，推送该分支：
git push origin feature/login-modal
然后去 Gitee/GitHub 发起 Pull Request（PR），邀请同事 review 代码，审核通过后再合并进主干。
光会基本操作还不够。要想长期稳定协作，还得做好这些细节。
.gitignore：别把垃圾带到仓库里有些文件根本不需要进版本控制，比如：
node_modules/（依赖包）unpackage/（HBuilderX 编译产物）.hbuilderx/（IDE 配置缓存）.log 日志文件/dist/ 构建输出目录在项目根目录创建 .gitignore 文件，内容如下：
# macOS .DS_Store Thumbs.db # Node.js node_modules/ npm-debug.log yarn-error.log .pnpm-debug.log # HBuilderX .hbuilderx/ unpackage/ # 构建输出 /dist/ /build/ # 日志 *.log # IDE .idea/ .vscode/ *.swp *~
✅ HBuilderX 本身不会自动忽略这些目录，必须手动配置
.gitignore！
Windows 默认换行符是 CRLF（\r\n），Linux/macOS 是 LF（\n）。如果不统一，可能导致：
解决方案：设置 Git 自动转换策略：
# 提交时转为 LF，检出时不转换（Windows 推荐） git config --global core.autocrlf true
或者更严格的跨平台兼容模式：
git config --global core.autocrlf input
如果已经出现大量换行符变更，可执行以下命令重置：
bash git rm --cached -r . git reset --hard
每次 push 都要输账号密码？太低效了。推荐使用 SSH 方式连接远程仓库。
打开 Git Bash，运行：
ssh-keygen -t rsa -C "[email protected]"
连续回车使用默认路径（通常是 C:\Users\你的用户名\.ssh\id_rsa.pub）。
id_rsa.pub 文件；ssh -T [email protected]
成功后会显示：
Welcome to Gitee.com, 张三!
现在你就可以用 SSH 地址克隆仓库了：
git clone [email protected]:teamname/project.git
再也不用手动输密码！
尽管 Git 很智能，但当两个人同时修改同一个文件的同一行时，仍然会发生冲突。
git pull ）；当拉取时发生冲突，HBuilderX 会在编辑器中标红冲突文件，内容类似：
<<<<<<< HEAD console.log("旧逻辑"); ======= console.log("新逻辑"); >>>>>>> feature/new-login
你需要手动删除 <<<<<<<、=======、>>>>>>> 标记，并保留正确的代码段。
修改保存后，将文件 add 并 commit，即可完成合并。
到现在为止，你应该已经完成了以下关键动作：
✅ 安装并验证 Git
✅ 配置 HBuilderX 正确识别 Git 路径
✅ 成功克隆或初始化项目
✅ 掌握 Add / Commit / Push / Pull 四大操作
✅ 学会使用分支开发
✅ 配置 .gitignore 和 SSH 密钥
✅ 理解换行符问题与冲突处理机制
这套流程看似琐碎，但它构成了现代软件开发的基础设施。特别是在使用 HBuilderX 开发 uni-app 这类需要频繁迭代的项目时，良好的版本管理习惯能极大减少'误删代码'、'覆盖他人修改'、'上线前不敢动'等问题。
不要等到'项目快上线了才想起来用 Git'，而应该： 🔧 从第一个文件就开始用 👥 让每位成员都掌握基础操作 📝 建立团队提交规范（如分支命名、提交格式）
当你能把版本控制变成一种肌肉记忆，你会发现：编码不再焦虑，协作变得从容。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online