diff --git a/docs/tutorial/run/run-app.md b/docs/tutorial/run/run-app.md
index 4b1e6b4033e610ff2c5b73fb8471b882fe9d6c1a..4199d10517301654bd72cbd249cbe0e3d2cc1674 100644
--- a/docs/tutorial/run/run-app.md
+++ b/docs/tutorial/run/run-app.md
@@ -94,9 +94,9 @@ HBuilder支持itunes协议,在HBuilder运行的电脑上,使用usb线连接i
HBuilderX 3.7.0+版本,新增 运行App项目到iOS真机,运行成功后,手机上的App会自动打开。
-
+**如下图所示:**
-
+
**注意:** MacOSX需要安装跟iOS手机系统相匹配的Xcode版本。 比如iPhone手机系统是iOS 16.2,那么也需要安装支持iOS 16.2的Xcode版本。如果`/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport`目录下不存在跟手机系统相匹配的`iOS Platforms`, 那么是无法自启动App的。请在手机端点击运行基座图标手动启动。
@@ -108,6 +108,11 @@ ls -lh /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/D
+MacOSX,如果无法自动启动App,请排查以下原因:
+- iOS手机系统没有匹配Xcode版本
+- 手机处于息屏状态
+- 项目编译运行失败、或安装基座失败
+
## 标准基座和自定义基座@customplayground
标准运行基座,是DCloud为方便开发者低门槛调试而提供的,此基座App使用的是DCloud的包名、证书和三方SDK配置。