语言支持

Javascript

Cocos Creator 3D 对脚本中 Javascript 语言的支持为 ECMAScript 2015。

TypeScript

Creator 3D 使用 babel 而非 tsc(Microsoft TypeScript Compiler) 编译 TypeScript 脚本。 特别地,使用了 @babel/plugin-transform-typescript (版本 7.5.2)插件。基于此原因,TypeScript 的支持存在某些限制,以下列举出了一些重要的注意事项, 关于完整的说明,见 @babel/plugin-transform-typescript

  • tsconfig.json 不会被读取;
  • 不支持 const enumexport =import =
  • 仅含类型声明的命名空间应以修饰符 declare 来声明;
  • 命名空间导出的变量必须声明为 const 而非 varlet
  • 同一命名空间的不同声明不会共享作用域,需要显式使用限定符。

@babel/plugin-transform-typescript 在编译时不会读取 tsconfig.json 意味着 tsconfig.json 的编译选项并不影响编译, 但存在例外。以下选项将被 Creator 3D 读取并影响编译:

  • compilerOptions.baseUrltsc 的语义相同,见
  • compilerOptions.pathstsc 的语义相同,见

以下 tsconfig.json 选项是隐含的:

  • emitDecoratorMetadata: false
  • esModuleInterop: true
  • experimentalDecorators: true
  • isolatedModules: true
  • target: es2015

你仍然可以在项目中使用 tsconfig.json 以配合 IDE 实现类型检查等功能。 为了使得 IDE 的 Typescript 检查功能 和 Creator 3D 行为兼容, 你需要额外注意一些事项,见 tsconfig

results matching ""

    No results matching ""