克隆失败主因是SSH密钥未正确配置或公钥未添加至GitHub；Java项目编译报错因Maven依赖未下载或settings.xml未配置；IDEA识别模块失败因未通过pom.xml导入；SSH超时可改用HTTPS或配置SSH走443端口。
克隆失败：提示 Permission denied (publickey)
这是最常卡住人的地方——不是 Git 没装好，而是远程仓库（比如 GitHub、GitLab）根本没认出你是谁。git clone 走 SSH 协议时，不靠账号密码，只认你本地的私钥。没配密钥，或者公钥没贴到平台账户里，就直接被拒。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用
ssh -T git@github.com测试连通性；失败就别急着 clone，先解决认证 - 生成密钥必须指定
-t ed25519（比默认 rsa 更安全、更短），命令是：ssh-keygen -t ed25519 -C "your_email@example.com" - 密钥默认存
~/.ssh/id_ed25519，别手贱改名或挪位置，否则ssh-agent找不到 - 把
cat ~/.ssh/id_ed25519.pub输出的整段内容，完整粘贴进 GitHub → Settings → SSH and GPG keys → New SSH key
Java 项目克隆后 mvn compile 报找不到依赖
克隆只是把代码拉下来，不等于环境就 ready。Java 项目依赖管理靠 pom.xml，但 Maven 默认不会自动下载所有依赖——尤其当你没配过本地仓库、或公司用了私有 Nexus 镜像却没同步 settings.xml 时。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先确认项目根目录下真有
pom.xml，没有的话可能 clone 错了分支（比如进了 docs 目录） - 检查
~/.m2/settings.xml是否存在；如果公司强制走内网镜像，缺这个文件就会卡在下载org.apache.maven:maven-model:3.8.6这类基础包 - 首次构建别直接
mvn clean install，先跑mvn validate，它能快速暴露 JDK 版本不匹配、profile 没激活等配置问题 - 留意控制台第一行输出的 Maven 版本，
mvn -v查一下——有些老项目只兼容Maven 3.5.x，新版会解析dependencyManagement出错
IDEA 里 import project 识别不出模块结构
不是项目有问题，是 IDEA 没按 Maven 方式导入。直接 Open Folder 或 Import Project 选错类型，会导致 src/main/java 不标蓝、target 不自动生成、甚至连 java.lang 都标红。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 关闭当前项目，在欢迎页点
Import Project，然后选中项目根目录下的pom.xml文件（不是文件夹） - 弹窗里务必勾选
Import project from external model → Maven，其他选项保持默认即可 - 如果已打开错误项目，别硬调设置——关掉项目，删掉根目录下的
.idea和*.iml文件，再重新 import - 检查 IDEA 右下角是否显示
Maven Projects面板；没有就去View → Tool Windows → Maven手动唤出，点刷新按钮
SSH 密钥配好了，但 clone 速度慢或超时
这不是网络问题，大概率是 DNS 解析卡在 github.com 或 SSH 默认端口 22 被防火墙拦截。企业网络尤其常见。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 试试换 HTTPS 协议 clone：
git clone https://github.com/xxx/yyy.git；虽然要输 token，但绕过 SSH 认证链，适合临时调试 - 如果坚持用 SSH，编辑
~/.ssh/config，加一段强制走 443 端口（GitHub 支持）：Host github.com HostName ssh.github.com Port 443 User git
- 确认没全局代理：运行
env | grep -i proxy，如果输出 http_proxy/https_proxy，临时取消：unset http_proxy https_proxy
密钥和 Maven 配置是两层独立的事，一个配错不影响另一个生效，但人容易以为“我 SSH 搞定了，那 mvn 肯定也行”，结果在依赖上空转半小时——得分开验证。
