内置类型

数字
字符串
布尔值
符文和音素群集
符号

Dart 语言对以下内容有特殊支持：

数字 (int 、 double)
字符串 (String)
布尔值 (bool)
记录 ((value1, value2))
函数 (Function)
列表 (List ，也称为数组 )
集合 (Set)
映射 (Map)
符文 (Runes ；通常被 characters API 替代)
符号 (Symbol)
null 值 (Null)

这种支持包括使用字面量创建对象的能力。例如， 'this is a string' 是一个字符串字面量， true 是一个布尔字面量。

因为 Dart 中的每个变量都引用一个对象——一个类的实例——你通常可以使用 构造函数 来初始化变量。一些内置类型有自己的构造函数。例如，你可以使用 Map() 构造函数来创建一个映射。

其他一些类型在 Dart 语言中也扮演着特殊角色：

Object ：除 Null 之外所有 Dart 类的超类。
Enum ：所有枚举的超类。
Future 和 Stream ：用于异步支持。
Iterable ：用于 for-in 循环和同步生成器函数。
Never ：指示表达式永远无法成功完成计算。最常用于始终抛出异常的函数。
dynamic ：指示您要禁用静态检查。通常应改用 Object 或 Object? 。
void ：指示从不使用值。通常用作返回类型。

Object 、 Object? 、 Null 和 Never 类在类层次结构中具有特殊作用。在理解空安全中了解这些作用。

Dart 数字有两种类型：

int: 不大于 64 位的整数值，取决于平台。在原生平台上，值可以是从 -2⁶³ 到 2⁶³ - 1。在 Web 上，整数值表示为 JavaScript 数字（64 位浮点数，没有小数部分），可以是从 -2⁵³ 到 2⁵³ - 1。
double: 64 位（双精度）浮点数，如 IEEE 754 标准所指定。

int 和 double 都是 num 的子类型。num 类型包括基本的运算符，如 +、-、/ 和 *，并且也是你可以在其中找到 abs() 、 ceil() 和 floor() 等方法的地方。（位运算符，如 >>，在 int 类中定义。）如果 num 及其子类型没有你正在寻找的内容， dart:math 库可能会有。

整数是没有小数点的数字。以下是定义整数字面量的一些示例：

dartvar x = 1;
var hex = 0xDEADBEEF;

如果数字包含小数点，则它是双精度浮点数。以下是定义双精度浮点数字面量的一些示例：

dartvar y = 1.1;
var exponents = 1.42e5;

你也可以声明一个变量为 num。如果你这样做，该变量可以同时具有整数值和双精度浮点数值。

dartnum x = 1; // x 可以同时具有 int 和 double 值
x += 2.5;

必要时，整数字面量会自动转换为双精度浮点数：

dart

double z = 1; // 等效于 double z = 1.0。

以下是如何将字符串转换为数字，反之亦然：

dart// String -> int
var one = int.parse('1');
assert(one == 1);

// String -> double
var onePointOne = double.parse('1.1');
assert(onePointOne == 1.1);

// int -> String
String oneAsString = 1.toString();
assert(oneAsString == '1');

// double -> String
String piAsString = 3.14159.toStringAsFixed(2);
assert(piAsString == '3.14');

int 类型指定了传统的按位移位（<<、>>、>>>）、补码（~）、AND（&）、OR（|）和 XOR（^）运算符，这些运算符对于操作和屏蔽位字段中的标志很有用。例如：

dartassert((3 << 1) == 6); // 0011 << 1 == 0110
assert((3 | 4) == 7); // 0011 | 0100 == 0111
assert((3 & 4) == 0); // 0011 & 0100 == 0000

有关更多示例，请参阅按位和移位运算符部分。

数字字面量是编译时常量。许多算术表达式也是编译时常量，只要它们的运算数是计算结果为数字的编译时常量即可。

dartconst msPerSecond = 1000;
const secondsUntilRetry = 5;
const msUntilRetry = secondsUntilRetry * msPerSecond;

有关更多信息，请参阅 Dart 中的数字。

你可以使用一个或多个下划线（_）作为数字分隔符，以使长的数字字面量更易于阅读。多个数字分隔符允许进行更高级别的分组。

dartvar n1 = 1_000_000;
var n2 = 0.000_000_000_01;
var n3 = 0x00_14_22_01_23_45;  // MAC 地址
var n4 = 555_123_4567;  // 美国电话号码
var n5 = 100__000_000__000_000;  // 一亿亿！

Dart 字符串（ String 对象）保存一系列 UTF-16 代码单元。你可以使用单引号或双引号来创建一个字符串：

dartvar s1 = 'Single quotes work well for string literals.';
var s2 = "Double quotes work just as well.";
var s3 = 'It\'s easy to escape the string delimiter.';
var s4 = "It's even easier to use the other delimiter.";

你可以使用 ${expression} 将表达式的值放在字符串中。如果表达式是标识符，则可以跳过 {} 。要获取与对象相对应的字符串，Dart 会调用对象的 toString() 方法。

dartvar s = 'string interpolation';

assert('Dart has $s, which is very handy.' ==
    'Dart has string interpolation, '
        'which is very handy.');
assert('That deserves all caps. '
        '${s.toUpperCase()} is very handy!' ==
    'That deserves all caps. '
        'STRING INTERPOLATION is very handy!');

你可以使用相邻的字符串字面量或 + 运算符来连接字符串：

dartvar s1 = 'String '
    'concatenation'
    " works even over line breaks.";
assert(s1 ==
    'String concatenation works even over '
        'line breaks.');

var s2 = 'The + operator ' + 'works, as well.';
assert(s2 == 'The + operator works, as well.');

要创建多行字符串，请使用带单引号或双引号的三引号：

dartvar s1 = '''
You can create
multi-line strings like this one.
''';

var s2 = """This is also a
multi-line string.""";

你可以通过在字符串前面加上 r 来创建一个“原始”字符串：

dart

var s = r'In a raw string, not even \n gets special treatment.';

有关如何在字符串中表达 Unicode 字符的详细信息，请参阅符文和音素群集。

字符串字面量是编译时常量，只要任何内插表达式是计算结果为 null 或数字、字符串或布尔值的编译时常量即可。

dart// 这些在 const 字符串中有效。
const aConstNum = 0;
const aConstBool = true;
const aConstString = 'a constant string';

// 这些在 const 字符串中无效。
var aNum = 0;
var aBool = true;
var aString = 'a string';
const aConstList = [1, 2, 3];

const validConstString = '$aConstNum $aConstBool $aConstString';
// const invalidConstString = '$aNum $aBool $aString $aConstList';

有关使用字符串的更多信息，请查看字符串和正则表达式。

为了表示布尔值，Dart 有一个名为 bool 的类型。只有两个对象具有 bool 类型：布尔字面量 true 和 false ，它们都是编译时常量。

Dart 的类型安全意味着你不能使用类似 if (nonbooleanValue) 或 assert (nonbooleanValue) 的代码。相反，请显式检查值，如下所示：

dart// 检查空字符串。
var fullName = '';
assert(fullName.isEmpty);

// 检查零。
var hitPoints = 0;
assert(hitPoints == 0);

// 检查 null。
var unicorn = null;
assert(unicorn == null);

// 检查 NaN。
var iMeantToDoThis = 0 / 0;
assert(iMeantToDoThis.isNaN);

在 Dart 中，符文公开了字符串的 Unicode 代码点。你可以使用 characters 包来查看或操作用户感知的字符，也称为 Unicode（扩展）音素群集。

Unicode 为世界所有文字系统中使用的每个字母、数字和符号定义了一个唯一的数值。因为 Dart 字符串是一系列 UTF-16 代码单元，所以要在字符串中表达 Unicode 代码点需要特殊的语法。表达 Unicode 代码点的常用方法是 \uXXXX ，其中 XXXX 是一个 4 位十六进制值。例如，心形字符 (♥) 是 \u2665 。要指定超过或少于 4 个十六进制数字，请将值放在花括号中。例如，大笑表情 (😆) 是 \u{1f606} 。

如果你需要读取或写入单个 Unicode 字符，请使用 characters 包中 String 上定义的 characters getter。返回的 Characters 对象是作为一系列音素群集的字符串。以下是如何使用 characters API 的示例：

dartimport 'package:characters/characters.dart';

void main() {
  var hi = 'Hi 🇩🇰';
  print(hi);
  print('The end of the string: ${hi.substring(hi.length - 1)}');
  print('The last character: ${hi.characters.last}');
}

输出（取决于你的环境）看起来像这样：

$ dart run bin/main.dart
Hi 🇩🇰
The end of the string: ???
The last character: 🇩🇰

有关使用 characters 包操作字符串的详细信息，请参阅 characters 包的示例和 API 参考。

Symbol 对象表示在 Dart 程序中声明的运算符或标识符。你可能永远不需要使用符号，但对于按名称引用标识符的 API 来说，它们非常宝贵，因为缩小会更改标识符名称，但不会更改标识符符号。

要获取标识符的符号，请使用符号字面量，它只是 # 后跟标识符：

#radix
#bar

符号字面量是编译时常量。

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。查看源代码或报告问题.