连接远程仓库与基础配置
打开WebStorm后，第一步是配置Git环境。点击左上角File菜单，选择Settings，进入Version Control下的Git选项。在Path to Git executable处，确认软件能自动识别本地的Git可执行文件路径。如果路径正确，点击Test按钮会显示当前Git版本号。接着配置用户信息，输入全局的Name和Email，这一步至关重要，因为每次提交都会记录这些信息用于追溯修改者。配置完成后点击Apply保存。
初始化项目与关联远程地址
对于全新项目，直接在项目根目录右键，选择Git下的Add Directory，将其标记为受Git管理。此时项目图标会变成绿色。如果是已有本地项目，先通过Terminal窗口执行git init命令，或者直接在Project面板右键选择Git下的Repository下Add Directory。关联远程仓库时，点击VCS菜单中的Import into Version Control并选择Share Project Repository，粘贴你的GitHub或Gitee远程仓库HTTPS地址。系统会自动拉取远程内容，完成初始同步。
日常代码提交与版本对比
编写代码过程中，右侧边栏的Changes面板会实时高亮显示修改过的文件。未添加的文件显示为白色，已跟踪但修改过的显示为红色，已暂存待提交的显示为蓝色。选中需要提交的文件，右键选择Git下的Commit File，或者直接使用快捷键Ctrl加K。在弹出的提交窗口中，务必填写清晰的Commit Message，描述本次修改的核心逻辑。勾选Commit only affected files可以只提交当前选中的文件，避免误提交无关内容。点击Commit完成本地暂存，随后点击右上角的Push按钮推送至远程服务器。
遇到代码写错想回退时，不要盲目删除。在Changes面板选中目标文件或整个项目，右键选择Compare with Last Commit，即可直观查看当前代码与上一次提交的差异。红色背景代表删除的内容，绿色背景代表新增的代码。这种可视化对比比命令行更友好，能快速定位问题所在。
分支管理与冲突解决
团队协作离不开分支操作。点击底部状态栏的分支名称下拉框，选择Checkout Branch，新建分支时输入名称并勾选Create branch。切换分支后，项目状态会同步更新。合并分支时，确保当前处于目标主干分支，然后选择Merge Changes，勾选源分支进行合并。如果两个开发者修改了同一文件的相同位置，WebStorm会弹出Conflict Resolution对话框。左侧是主干代码，中间是当前合并进来的代码，右侧是最终结果。手动编辑中间区域保留需要的逻辑，确认后点击Mark as Resolved即可完成合并。
实用快捷操作与效率提升
频繁提交临时修改时，可以使用Stash功能。在Changes面板顶部找到Stash Changes图标，点击后会将当前所有未提交改动打包隐藏，保持工作区干净。需要恢复时，再次点击该图标选择Unstash Changes即可还原。查看提交历史非常简单，直接双击底部的Log标签页，以时间轴形式展示所有节点。鼠标悬停在具体提交上，还能看到详细的文件变更列表。若发现某次提交严重错误，可在该节点右键选择Revert Change List，生成反向补丁自动回滚，无需手动撤销每一行代码。
避坑指南与规范建议
新手使用Git最容易犯的错误就是乱用强制推送。在推送前务必检查本地与远程的差异，优先使用Pull拉取最新代码再合并，而不是Force Push覆盖远程历史。另外，Large Files警告经常会出现，这是因为仓库里塞进了过大的二进制文件。建议在项目根目录创建.gitignore文件，将node_modules、dist、日志文件等排除在外。定期清理无用分支，保持仓库整洁。掌握这些基础操作后，WebStorm的Git集成能让你专注于业务逻辑开发，大幅降低版本管理的学习成本。
