diff --git a/docs/plugin/uts-for-android.md b/docs/plugin/uts-for-android.md
index 8cde8d2971440d6d6335a3b6378d1e5ce3d38745..96e9578ff6be082d0ba2f28c9fcd68c0bb946615 100644
--- a/docs/plugin/uts-for-android.md
+++ b/docs/plugin/uts-for-android.md
@@ -889,7 +889,7 @@ getUniActivity()!.startActivity(intent);
 某些场景下开发者需要获得 指定double数据类型的数据
 
 开发者下意识的写法可能是：
-```
+```ts
 // 这样是错误的
 let a:Int =3
 let b:Int =4
@@ -898,7 +898,7 @@ let c:Double  = a/b
 
 但是Android原生环境中，数据类型的精度是向下兼容的，如果想要获得一个double类型，必须要有一个double类型参与运算：
 
-```
+```ts
 // 这样才是正确的
 let a:Int =3
 let b:Int =4
@@ -1016,4 +1016,4 @@ class CustomThread extends Thread{
 
 ### 7.1 结构入参 boolean 参数默认为true
 
-当以type 结构体为参数时，其内部boolean字段 默认值为false,不支持指定。
+当以type 结构体为参数时，其内部boolean字段 默认值为false，不支持指定。
diff --git a/docs/plugin/uts-for-ios.md b/docs/plugin/uts-for-ios.md
index 8de3cd702ee97f33348313dcdf683ee604e2ba2a..8c96be21295fdc9e9cf9fa159848d784d985225c 100644
--- a/docs/plugin/uts-for-ios.md
+++ b/docs/plugin/uts-for-ios.md
@@ -151,7 +151,7 @@ import { DCUTS } from "DCUTSFoundation"
 
 `~/uni_modules/uts-alert/utssdk/app-ios/index.uts`
 
-```
+```ts
 export function showAlert(title: string|null, message: string|null, result: (index: Number) => void) {
 	// uts方法默认会在子线程中执行，涉及 UI 操作必须在主线程中运行，通过 DispatchQueue.main.async 方法可将代码在主线程中运行
 	DispatchQueue.main.async(execute=():void => {
@@ -280,7 +280,7 @@ var alert = new UIAlertController()
 
 示例
 
-```
+```swift
 // swift
 var alert = UIAlertController(title: "提示", message: "提示内容", preferredStyle: .alert);
 ```
diff --git a/docs/tutorial/syntax-uts.md b/docs/tutorial/syntax-uts.md
index 9d5cf72b7e5ed198c38fe50c5e75b1384e720ed6..14b53d8246da8924a424a766edbd8d330f0b0704 100644
--- a/docs/tutorial/syntax-uts.md
+++ b/docs/tutorial/syntax-uts.md
@@ -173,8 +173,8 @@ uts的多个代码语句，可以以回车或分号分割。行尾的分号可
 
 ```ts
 let a:number = 1 //行尾可以不加分号
-let b:number = 2;
-let c:number = 3 ; let d:number = 4 // 同行需要用分号分割
+let b:boolean = false; //行尾可以加分号
+let c:number = 3 ; let d:number = 4 // 同行多语句需要用分号分割
 ```
 
 ## 数据类型
@@ -185,7 +185,19 @@ let c:number = 3 ; let d:number = 4 // 同行需要用分号分割
 
 ### 数字（Number）
 
-整数或浮点数，例如： `42` 或者 `3.14159` 或者 `-1` 。
+所有数字，包括整数或浮点数，包括正数负数。例如： 正整数 `42` 或者 浮点数 `3.14159` 或者 负数 `-1` 。
+
+```ts
+let a:number = 42
+```
+
+在 kotlin 和 swift 中，数字还有其他分支类型，包括Int、Float、Double。有些系统API或三方SDK的传入和返回强制约定了这些分支类型，此时无法使用 number。
+这种情况下可以使用下面的方法，虽然可能会被编辑器报语法错误（后续HBuilderX会修复这类误报），但编译到 kotlin 和 swift 时是可用的。
+```ts
+let a:Int =3 //注意目前Int是首字母大写，后续可能会调整
+let b:Int =4
+let c:Double  = a * 1.0 / b
+```
 
 ### 字符串（String）
 
@@ -195,14 +207,17 @@ let c:number = 3 ; let d:number = 4 // 同行需要用分号分割
 
 日期对象表示日期，包括年月日时分秒等各种日期。详[见下](#Date)
 
-<!-- ### json
-
-json对象，详[见下](#json) -->
-
 ### null
 
 一个表明 null 值的特殊关键字。
 
+有时需定义可为null的字符串，可以在类型描述中使用`|`操作符。
+```ts
+let user: string | null
+```
+
+> 注意：uts 编译为kotlin和swift时不支持 undefined。
+
 ### Object类型
 
 对象（object）是指内存中的可以被标识符引用的一块区域，是一种引用类型。包括Array，Date，Map，Set，JSON等，uts 有一个内置对象的标准库。详[见下](#内置对象和api)。