diff --git a/docs/tutorial/harmony/runbuild.md b/docs/tutorial/harmony/runbuild.md
index 9421ac2d9d42f9325ec9eea46eb348de502a18c1..563921720e0f31d8426f403b6afe3f3f24c4c6a6 100644
--- a/docs/tutorial/harmony/runbuild.md
+++ b/docs/tutorial/harmony/runbuild.md
@@ -17,6 +17,7 @@
   - HBuilderX 4.24+ 要求 DevEco-Studio 5.0.3.400+，HBuilderX 4.31+ 要求 DevEco-Studio 5.0.3.800+。
   - 鸿蒙系统版本 API 12 以上 （DevEco-Studio有内置鸿蒙模拟器）
 - HBuilderX 4.31+ 构建的鸿蒙运行包不支持 x86_64 平台，会影响到 Windows 系统和部分 Mac 系统的鸿蒙模拟器无法使用，需使用真机调试
+- **项目的路径不要太深，如果项目路径过长会导致编译失败，建议将项目放在盘符根目录下**
 
 **Windows系统如使用模拟器则需要开启以下功能**