intellij idea中git路径配置错误导致“command not found”,需在settings > version control > git中填写完整路径(如windows为git\bin\git.exe,macos为/opt/homebrew/bin/git);ssh密钥需生成、加载并绑定github,且远程url须为git@格式;.gitignore应添加/target/、/build/、*/.iml;windows中文路径乱码需设置core.quotepath false及utf-8编码。

IntelliJ IDEA 里 Git 路径配不对,git 命令报 “Command not found”
IDE 找不到系统 git,本质是没设对可执行文件路径。Windows 默认装在 Git\bin\git.exe,macOS / Linux 一般在 /usr/bin/git 或 /opt/homebrew/bin/git(M1/M2);用 which git 或 where git 确认真实路径。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 进
Settings > Version Control > Git,填完整路径,别只写git - 如果用 Homebrew 安装 Git,别选
/usr/bin/git—— 那是系统自带的过期版本,常导致fatal: unable to access类 SSL 错误 - 改完点
Test按钮验证,成功才继续;否则后续所有 push/pull 都会静默失败
SSH 秘钥生成后 GitHub 仍提示 Permission denied (publickey)
不是秘钥没生成,而是 SSH agent 没加载、或 GitHub 没绑定公钥、或 Git URL 还在用 HTTPS。三者缺一不可。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 用
ssh-keygen -t ed25519 -C "your_email@example.com"生成新密钥(别用 RSA,GitHub 已不推荐) - 运行
eval "$(ssh-agent -s)"启动 agent,再用ssh-add ~/.ssh/id_ed25519加载私钥 - 把
cat ~/.ssh/id_ed25519.pub输出内容整段粘贴到 GitHub Settings > SSH and GPG keys 页面 - 检查远程地址:
git remote set-url origin git@github.com:user/repo.git(必须是git@...格式)
Java 项目中 .gitignore 必须屏蔽的几类文件
忽略错会导致敏感信息泄露(如数据库密码)、IDE 冗余文件污染仓库、或编译产物冲突。默认模板常漏掉关键项。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 加这三行防踩坑:
/target/(Maven)、/build/(Gradle)、**/*.iml(IntelliJ 项目文件) -
src/main/resources/application.properties不能直接 ignore,但应拆出application-dev.properties并 ignore 开发配置;用 Spring Profiles +spring.profiles.active控制环境 - 避免写
*.jar—— 它会误杀你手动放进去的第三方依赖 jar;改用/lib/*.jar或明确路径 - 确认生效:改完
.gitignore后运行git rm -r --cached . && git add .刷新索引
Windows 上中文路径提交乱码,git status 显示一堆问号文件
Git 默认用 UTF-8,但 Windows 控制台和旧版 Git 用 GBK,造成编码错位。不是文件损坏,是显示层解码失败。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 全局设置 Git 使用 UTF-8:
git config --global core.quotepath false(让路径原样输出) - 再加:
git config --global i18n.commitencoding utf-8和git config --global i18n.logoutputencoding utf-8 - IntelliJ 用户额外检查:
Help > Edit Custom VM Options,追加-Dfile.encoding=UTF-8,重启 IDE - 已乱码的文件名不用删重提,用
git add -f "文件名"强制添加一次即可恢复识别
.gitignore 却没清缓存。这些点不报错,但会让后续操作持续失效。










