内置类型

数字
字符串
布尔值
Runes 和字素簇
符号

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

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

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

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

一些其他类型在 Dart 语言中也具有特殊的作用

Object：所有 Dart 类的超类，除了 Null。
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;

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

dartvar y = 1.1;
var exponents = 1.42e5;

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

dartnum x = 1; // x can have both int and double values
x += 2.5;

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

dart

double z = 1; // Equivalent to 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 address
var n4 = 555_123_4567; // US Phone number
var n5 = 100__000_000__000_000; // one hundred million million!

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.";

你可以使用 ${表达式} 将表达式的值放在字符串中。如果表达式是标识符，你可以跳过 {}。为了获得与对象对应的字符串，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 字符的详细信息，请参阅Runes 和字素簇。

字符串字面量是编译时常量，只要任何插值表达式是求值为 null 或数值、字符串或布尔值的编译时常量。

dart// These work in a const string.
const aConstNum = 0;
const aConstBool = true;
const aConstString = 'a constant string';

// These do NOT work in a const string.
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 (非布尔值) 或 assert (非布尔值) 这样的代码。相反，显式检查值，像这样

dart// Check for an empty string.
var fullName = '';
assert(fullName.isEmpty);

// Check for zero.
var hitPoints = 0;
assert(hitPoints == 0);

// Check for null.
var unicorn = null;
assert(unicorn == null);

// Check for NaN.
var iMeantToDoThis = 0 / 0;
assert(iMeantToDoThis.isNaN);

在 Dart 中，runes 公开了字符串的 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.7.1。页面上次更新于 2025-02-28。查看源代码或报告问题。