运行环境

Cocos Creator 3.0 引擎的 API 都存在模块 cc 中，使用标准的 ES6 模块导入语法将其导入：

import {
  Component, // 导入类 Component
  _decorator, // 导入命名空间 _decorator
  Vec3, // 导入类 Vec3
} from "cc";
import * as modules from "cc"; // 将整个 Cocos Creator 模块导入为命名空间 Cocos Creator

@_decorator.ccclass("MyComponent")
export class MyComponent extends Component {
  public v = new Vec3();
}

保留标识符 cc

注意，由于历史原因，cc 是 Cocos Creator 3.0 保留使用的标识符，其行为 相当于 在任何模块顶部定义了名为 cc 的对象。 因此，开发者不应该将 cc 用作任何 全局对象 的名称：

/* const cc = {}; // 每个 Cocos Creator 脚本都等价于在此处含有隐式定义 */

import * as modules from "cc"; // 错误：命名空间导入名称 cc 由 Cocos Creator 保留使用

const cc = {
  x: 0,
};
console.log(cc.x); // 错误：全局对象名称 cc 由 Cocos Creator 保留使用

function f() {
  const cc = {
    x: 0,
  };
  console.log(cc.x); // 正确：cc 可以用作局部对象的名称

  const o = {
    cc: 0,
  };
  console.log(o.cc); // 正确：cc 可以用作属性名
}

console.log(cc, typeof cc); // 错误：行为是未定义的