goland中git需手动启用并绑定本地仓库，否则vcs菜单灰显、右键无git选项；须确认存在.git目录，再通过vcs→enable version control integration选择git，且确保git路径配置正确、user.name/user.email已设置。
GoLand 里 Git 不是开箱即用的，不手动绑定仓库、配对 git 可执行文件、设置 user.name/user.email，VCS 菜单就一直灰着，Commit/ Push 全部点不动。
为什么 VCS 菜单灰显、右键没 Git 选项
根本原因：GoLand 没识别到当前项目是一个 Git 仓库。
- 先检查项目根目录下是否存在
.git文件夹 —— 没有就不是仓库，得先在终端运行git init或git clone - 已有
.git但 IDE 没反应？点击VCS → Enable Version Control Integration，弹窗中选Git，点 OK - 注意路径陷阱：如果项目结构是
myproject/backend，而你在backend目录打开 GoLand，IDE 默认把backend当作仓库根；但若.git实际在myproject，就得手动把项目根设为myproject，否则内部文件不被追踪
Path to Git executable 配错会怎样
路径错 ≠ 报错提示明显，而是“点了没反应”或提交后卡住不动。
- Windows 推荐填
C:\Program Files\Git\bin\git.exe（不是cmd\git.exe） - macOS/Linux 用
/usr/bin/git或运行which git输出的真实路径 - 改完必须点
Test按钮验证；若报Cannot run program "git": error=2, No such file or directory，说明路径不存在或权限不足 - GoLand 启动时只读一次 Git 路径，改完要重启 IDE 才生效
冲突对话框里 “Apply All Non-Conflicting Changes” 为啥点不动
这个按钮不是总可用，它受文件类型、冲突粒度和后台状态三重限制。
-
go.mod文件冲突时，该按钮完全不响应 —— GoLand 把它当结构化配置处理，不允许自动合并 require 行 - 冲突块中含
func、type、const等关键字时，默认禁用自动合并，防止语法破坏 - 若底部状态栏显示
Indexing…（gopls 正在解析），Resolve 窗口可能延迟加载，此时点击无反应，需等 indexing 完成 - 简单冲突（如同一行左改变量名、右改注释）可点
Solve simple conflicts一键合并，但它不会被Apply All Non-Conflicting Changes覆盖
多 Commit Squash 合并失败的常见卡点
Squash 不是“选中一堆提交点一下就行”，它对历史结构非常敏感。
- 必须在
Git 工具窗口（Alt+9）→ Log 标签页操作，Commit 工具窗口里不支持多选 - Ctrl/Cmd 多选或鼠标拖拽都行，但所选提交必须是**同一分支上的连续祖先链**，中间不能跳 commit，也不能含
merge commit - 一旦含 merge commit 或跨分支，
Squash Commits按钮直接置灰，无任何提示 - 合并后务必重写
Commit Message—— 默认生成的squash of 5 commits不符合团队规范，也难追溯
最常被忽略的是：换行符差异（Contents have differences only in line separators）会让整个项目所有文件变红，但它不报错、不阻断操作，却极大干扰代码审查和 diff 判断。这个问题必须在初始化仓库时就通过 .gitattributes 和 GoLand 的 Line Separators 设置一并解决，而不是等到 PR 被拒才回头补。
