离线安装JDK需配置JAVA_HOME和PATH并验证版本；IDEA离线需预装插件并禁用更新；Maven须配置settings.xml指向本地仓库且注释镜像；Gradle需修改distributionUrl为file:///协议并启用--offline。
离线安装 JDK：别直接解压完就以为能用
离线环境下最常踩的坑是只下载了 tar.gz 包解压，却没配好 JAVA_HOME 和 PATH。Linux/macOS 需手动写入 shell 配置（如 ~/.bashrc 或 ~/.zshrc），Windows 则必须通过「系统属性 → 高级 → 环境变量」添加，不能只靠临时 set 命令。
-
JAVA_HOME必须指向 JDK 根目录（如/opt/jdk-17.0.1），不是bin子目录 - 验证是否生效：运行
java -version和javac -version，二者输出版本号必须一致 - 若提示
command not found，大概率是PATH没包含$JAVA_HOME/bin
IDE 离线安装与插件预载：IntelliJ IDEA 最容易卡在“正在加载插件列表”
IDEA 默认启动时会联网检查插件更新，离线环境会卡住或报错 Plugin manager is not available。解决方式不是关网络再重装，而是提前准备：
- 在有网机器上用相同版本 IDEA，进入
Settings → Plugins，勾选常用插件（如Lombok、MyBatisX、GitToolBox），点击右下角Install Plugin from Disk…导出为.jar文件 - 离线机安装 IDEA 后，禁用自动检查：启动时按住
Shift两次 → 选择Configure → Settings → System Settings → Updates→ 取消勾选Automatically check updates - 手动安装插件：用
Install Plugin from Disk…加载之前导出的.jar，重启生效
Maven 离线仓库：不配置 settings.xml 就算有 jar 也编译不过
只把 ~/.m2/repository 整个拷过去不行——Maven 会因缺失 settings.xml 中的本地仓库路径定义，仍尝试去默认路径找，或者因镜像配置残留导致超时。
github-repo-analyzer
下载
当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。
- 确保离线机的
$M2_HOME/conf/settings.xml中<localrepository></localrepository>明确指向你拷贝来的仓库路径，例如：<localRepository>/opt/m2/repository</localRepository>
- 注释掉所有
<mirror></mirror>节点，避免 Maven 尝试连接已失效的远程地址 - 首次运行
mvn compile前加-o参数强制离线模式：mvn -o compile，否则它仍会尝试校验 SNAPSHOT 版本
Gradle 离线构建：比 Maven 更隐蔽的联网行为
Gradle 默认会在首次构建时下载 gradle-wrapper.jar 和对应版本的二进制包，即使项目自带 gradle/wrapper/gradle-wrapper.jar，它也可能因校验失败重新联网。
立即学习“Java免费学习笔记（深入）”；
- 确认
gradle/wrapper/gradle-wrapper.properties中的distributionUrl是file:///协议，例如：distributionUrl=file:///opt/gradle/gradle-8.4-bin.zip
- 把对应版本的完整 Gradle 发行包（
bin.zip）提前解压到指定路径，并确保权限可读 - 执行时显式启用离线：
./gradlew build --offline；若提示Could not resolve org.gradle:gradle-core-api，说明 wrapper 没走本地路径，要检查distributionUrl的协议和路径拼写
settings.xml 多一行空格、Gradle 的 file:// 写成 file:/，都足以让整个构建链卡死在某个看似无关的环节。 
