鸿蒙5.0开发进阶：配置构建-自定义.hvigor目录路径

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

自定义.hvigor目录路径

.hvigor目录默认位于用户目录下：

• Windows：C:\Users\username\.hvigor
• macOS：/Users/UserName/.hvigor
• Linux：
  • root用户：/root/.hvigor
  • 非root用户：/home/UserName/.hvigor

若默认目录的磁盘空间不足，开发者需要自定义.hvigor目录路径，可通过以下方式自行配置。

说明

该功能从DevEco Studio 5.0 Canary1版本开始支持。

• Windows环境变量设置方法：

  在系统或者用户的变量中，添加自定义.hvigor目录的绝对路径。

  变量名：HVIGOR_USER_HOME

  变量值：自定义存放.hvigor目录的绝对路径。如D:\HvigorUserHome

  

• macOS环境变量设置方法：在macOS上为DevEco Studio设置环境变量需要使用launchd来设置。
  • 临时生效的设置方式：在终端中执行launchctl setenv语句并重新启动DevEco Studio即可。

    launchctl setenv HVIGOR_USER_HOME /User/xx #本处路径请替换为.hvigor目录的绝对路径

    该设置方式在重启电脑后将失效。

  • 重启不失效的设置方式：

    说明

    在macOS上设置系统变量的方式因系统版本不同而存在多种差异，以下仅为在macOS上为DevEco Studio设置系统变量的一种示例，具体设置方式以系统版本为准。

    在/etc/launchd.conf（若该文件不存在，可自行创建）中添加如下内容。

    setenv HVIGOR_USER_HOME /User/xx #本处路径请替换为.hvigor目录的绝对路径

    设置完成后，重启电脑后才可生效。

• Linux环境变量设置方法：

  打开终端工具，执行以下命令。

  vim ~/.bashrc

  添加HVIGOR_USER_HOME环境变量。

  export HVIGOR_USER_HOME=/home/xx  #本处路径请替换为.hvigor目录的绝对路径

  保存并关闭文件，使用source命令重新加载.bashrc配置文件。

  source ~/.bashrc