当前位置：首页 > article >正文

uniapp x 学习之 uts 语言快速入门

article 2025/3/6 12:21:46

文章目录

一、UTS 介绍
二、用途和关系
三、类型声明
- 3.1 变量定义（let）
- 3.2 常量定义（const）
- 3.3 变量命名规则
- 3.4 方法参数及返回值类型定义
- 3.5 vue data类型定义
四、设计思路

一、UTS 介绍

uts 全称 uni type script，是一门跨平台的、高性能的、强类型的现代编程语言。

它可以被编译为不同平台的编程语言，如：

Web平台/小程序，编译为 JavaScript
Android平台，编译为 Kotlin
iOS平台，编译 Swift
鸿蒙OS平台，编译为 ArkTS

uts 采用了与 ts 基本一致的语法规范，支持绝大部分 ES6 API。

但为了跨端，uts 进行了一些约束和特定平台的增补。
过去在 js 引擎下运行支持的语法，大部分在 uts 的处理下也可以平滑的在 kotlin 和 swift 中使用。但有一些无法抹平，需要使用条件编译。

和 uni-app 的条件编译类似，uts 也支持条件编译。写在条件编译里的，可以调用平台特有的扩展语法。

二、用途和关系

uts 是一门语言。也仅是一门语言，不包含 ui 框架。

uvue 是 DCloud 提供的跨平台的、基于 uts 的、使用 vue 方式的 ui 框架。

uts 相当于 js，uvue相当于 html 和 css 。它们类似于 v8 和 webkit 的关系，或者类似于 dart 和 flutter 的关系。

uts 这门语言，有2个用途：

开发 uni-app 和 uni-app x 的原生扩展插件：因为 uts 可以调用所有原生能力。
2.uts 和 uvue 一起组合，开发原生级的项目，也就是 uni-app x 项目。

uts 可以在 uni-app 中使用，也可以在 uni-app x 中使用。

主语言区分：

在 uni-app 中，主编程语言是 js 。uts可以开发原生插件，包括API插件和组件插件。
在 uni-app x 中，主编程语言是 uts 。不管是应用逻辑还是扩展插件，均使用 uts 编程。仅在Web平台和iOS的 js 驱动模式下可以使用 js 。

可以通过表格更清晰的了解 uts 语言在 uni-app 和 uni-app x 下的编译关系。

在这里插入图片描述
这里的概念解释是：

uts 插件，指 uni_modules 目录下 utssdk 目录下的代码。
除 uts 插件外，其他都属于普通页面和脚本，包含 vue、nvue、uvue 等页面及单独的 uts 文件。
在 uni-app x 的 iOS 平台，目前普通页面和脚本是编译为 js 的，而不是Swift 。这个策略主要是为了解决 windows 电脑开发 uni-app x 的问题。它并不影响性能，uni-app x 的iOS通过优化解决了 js 性能问题。同时未来也会提供 js 驱动和 Swift 驱动双选。

除了查阅表格，也可以简单的记3个原则：

所有的 uts 插件，都会编译为原生语言。
web 和小程序上，原生语言就是 js 。
App上，目前仅 uni-app x 的 ·Android· 平台会编译为原生语言，其他都编译为 js 。

三、类型声明

js 是无类型的，TypeScript 的 type 就是类型的意思，给 js 加上了类型。它的类型定义方式是在变量名后面通过加冒号和类型来进行定义。

uts 中声明变量可以用 let 或 const，详见下。

3.1 变量定义（let）

声明一个可重新赋值的变量。语法 let [变量名] : [类型] = 值; 。

相当于 TypeScript 中的 let、kotlin 中的 var、swift 中的 var。

let str :string = "hello"; // 声明一个字符串变量
str = "hello world"; // 重新赋值

3.2 常量定义（const）

声明一个只读常量，只能为其赋值一次。语法 const [变量名] : [类型] = 值; 。

相当于 TypeScript 中的 const、kotlin 中的 val、swift 中的 let。

const str :string = "hello"; // 声明一个字符串常量
str = "hello world"; // 报错，不允许重新赋值

🌈注意事项：

当前 uts 并未限制使用 var 来声明变量，但除非你知道你在做什么，否则不要轻易使用它，因为有不同平台差异：
- 编译至 JavaScript 平台时，等同于 JavaScript 平台的 var 。存在变量提升现象，具体参考 var 和 let 的区别
- 编译至 Kotlin 平台时，等同于 Kotlin 平台的 var（允许重新赋值）
swift 中 let 是定义常量，而 uts 和 ts 中，let 是定义变量。注意勿混淆。
类型定义的冒号，左右可以有一个空格，也可以没有空格。let str:string 和 let str :
string 和 let str :string 和 let str: string 都是合法的。

3.3 变量命名规则

在 uts 中，使用变量名需要遵守一定的规则。

变量名称可以包含数字和字母。
除了下划线 _ 外，不能包含其他特殊字符，包括空格。
变量名不能以数字开头。

3.4 方法参数及返回值类型定义

方法的参数、返回值，也通过冒号定义。

如下示例，方法 test，有一个参数 score ，是 number 类型，方法返回值类型为boolean 类型。

function test(score: number): boolean {
	return (score>=60)
}
test(61) // 返回true

方法无返回值时，使用 :void 。

function add(x :string, y :string) :void {
    let z :string = x + " " + y
	console.log(z)
	// 不需要return
}

3.5 vue data类型定义

vue 选项式开发时，冒号被用于赋值，无法通过 let、const 和冒号来定义 data 数据的类型。

此时可以使用字面量赋值自动推导；也可以使用 as 关键字来显式声明类型。

<script lang="uts">
	export default {
		data() {
			const date = new Date()
			return {
				s1 : "abc", // 根据字面量推导为string
				n1 : 0 as number, // 这里其实可以根据字面量自动推导，as number写不写都行
				n2, // 不合法，必须指定类型
				n3 as number, // 不合法，uts不支持undefined，必须通过冒号初始化赋值，哪怕赋值为null，见下
				n4 : null as number | null // 合法。定义为可为null的数字，初始值是null，但在使用n4前必须为其赋值数字。（number | null）是一个或的写法，前后顺序没有关系。uts的联合类型只支持 |null 。
				year: date.getFullYear() as number, // 在data里，目前无法通过变量类型推导data项的类型，需使用 as 显式声明类型为number
			}
		}
	}
</script>