作为一个电脑小白,最近我在准备 Flutter 开发环境,第一步就是安装 Git。结果刚一开始就遇到了问题:安装包 Git-2.52.0-setup.exe 跑到最后一步就卡住了,进度条一直停在 99.99%,反复试了好几次都这样。

问题具体表现

  • Git 安装程序执行至最后阶段,进度条固定在 99.99%,长时间无任何推进
  • 等待 15 分钟后仍无响应,强制关闭程序重新安装,问题重复出现
  • 强行完成安装后,在 DevEco Studio 中调用 Git 功能,软件无任何响应,无法正常使用

因此询问豆包,

一开始我以为是小问题,跟着网上的教程试了很多常规操作:

针对上述问题,由简单到复杂的尝试了常规排查方法,均未解决问题,具体操作如下:

  1. 耐心等待加载:排除临时网络或系统卡顿问题,持续等待 15 分钟,进度无变化
  2. 管理员权限运行:右键安装包选择「以管理员身份运行」,规避权限不足问题,安装仍卡死
  3. 关闭干扰软件:关闭电脑杀毒软件、防火墙等安全程序,防止安装进程被拦截,无效
  4. 结束进程重试:在任务管理器中结束 Git 安装进程,清理临时文件后重新安装,问题依旧
  5. 更换安装包版本:重新下载不同版本的 Git 安装包,排除安装包损坏问题,仍卡在 99.99%

经过多轮尝试后,排查到核心问题:安装目标磁盘的分区名称包含中文,虽安装包下载路径为纯英文,但 Git 工具对中文磁盘分区名存在兼容性问题,导致安装进程无法正常完成。期间尝试将含中文的 B 盘重命名为纯英文,可解决问题;直接更换至无中文路径的 C 盘,操作更快捷。

最终有效解决步骤

  1. 重新选择安装路径:将 Git 安装至无中文、无特殊字符的 C 盘根目录下的指定文件夹
  2. 重新执行安装:双击安装包,按默认步骤完成安装,全程无卡顿,顺利结束
  3. 功能验证:打开 DevEco Studio,调用 Git 相关功能,软件响应正常,可正常使用

最终我明白了开发工具的安装,不仅安装路径需为纯英文 + 数字所在磁盘的分区名称也需避免中文、空格及特殊字符,否则易出现兼容性卡顿、功能失效等问题。本次问题耗时 3 小时解决,核心原因是初期忽略了磁盘分区名的影响,后续搭建开发环境时,会先统一检查所有路径的规范性,从源头规避此类问题,提升环境搭建效率。

下次如果按还有类似的遇到开发工具安装卡顿问题时,我就可按「等待重试→权限排查→干扰软件排查→路径规范性排查」的流程逐步定位问题,减少无效尝试的时间消耗。

git解决后,我开始下载jdk17

  • 选择正规渠道:优先从 OpenJDK 官网(https://jdk.java.net/17/)下载,避免第三方修改版,防止缺失文件、引发兼容性问题;
  • 匹配系统版本:根据电脑系统选择对应安装包,Windows 系统下载「x64 Installer」版本,适配 64 位系统;
  • 提前准备安装路径:在 B盘创建纯英文无特殊字符的目录(如 C:\Software\JDK17),避免后续因路径问题导致配置失败

按照教程下载安装完毕,开始配置系统环境变量,这个对于我来说是新的知识,

  1. 右键「此电脑」→选择「高级系统设置」→点击弹窗下方「环境变量」;
  2. 配置 JAVA_HOME 变量:在「系统变量」栏点击「新建」,变量名输入JAVA_HOME,变量值输入 JDK17 的安装路径,点击「确定」;
  3. 配置 Path 变量:在「系统变量」栏找到Path变量并双击,点击「新建」,输入%JAVA_HOME%\bin,点击「上移」将其置顶,依次点击「确定」保存所有配置;

配置完成后验证是否成功

  • 按下「Win+R」,输入cmd打开命令提示符窗口;
  • 在窗口中输入验证命令:java -version,按下回车;
  • 若窗口显示 JDK17 的版本信息(如 openjdk version "17.0.0" ),说明下载、安装、环境配置全部成功;若提示 “不是内部或外部命令”,则需检查路径是否正确、环境变量是否保存

在安装完成jdk17并在我的电脑验证成功的过程中,我学习到了很多新的知识,我学会怎么打开cmd和powershell,以及用管理员身份打开等,这对于我来说是一个很大的进步。

欢迎加入开源鸿蒙跨平台社区:
https://openharmonycrossplatform.csdn.net

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐