游戏引擎 / 系统课时
把 import 和 export 接到脚本
把 import 和 export 接到脚本
当两个组件都要计算升级分数时,直接复制公式会让修改分散。本节把计分规则提取成一个不依赖引擎的模块,先验证函数输出,再接入 Cocos 组件,建立模块导出、相对导入与场景行为的明确边界。
学习目标
- 用命名导出和相对导入连接多文件代码。
- 区分纯逻辑模块与继承 Component 的脚本。
- 根据文件路径和导出名称定位模块错误。
按职责拆开两个文件
共享模块只负责计分,不应读取场景节点、操作 Label 或自动启动游戏。组件负责生命周期与引擎交互,把取得的数据传给共享函数。这样能在普通 TypeScript 环境先验证公式,再在 Creator 中验证组件接入,减少两种环境的问题相互干扰。
命名导出使用 export 声明,导入时名称必须匹配。相对路径从当前文件出发,./score 表示同一目录下的 score 模块。文件搬家后要同步修正路径;运行时导入应对应真实文件,类型专用声明可以用 import type,避免把纯类型当运行时值使用。
独立运行共享逻辑
以下两文件组成完整纯 TypeScript 主例程,放在同一目录,一起用 strict 检查并编译,再运行 dist/main.js。文件:score.ts。
export function scoreForLevel(level: number): number {
// 配置边界拒绝小数、负值和非有限值。
if (!Number.isInteger(level) || level < 1) {
throw new Error('invalid level');
}
return level * 100;
}该文件只导出函数,不自行打印。验证行为由下面入口完成。文件:main.ts。
import { scoreForLevel } from './score';
// 入口承担验证,模块承担可复用的计算。
console.log(scoreForLevel(3));
try {
scoreForLevel(0);
} catch (error: unknown) {
console.log(error instanceof Error ? error.message : 'unknown');
}预期输出:
300
invalid level两文件编译命令使用 tsc main.ts score.ts --strict --target ES2022 --module commonjs --outDir dist。这里选择 CommonJS 是为了 Node.js 验证,源码仍使用 import/export。Creator 项目应沿用它自身的模块构建配置,不要为了复用终端命令随意替换项目 tsconfig。
接到真实组件入口
文件:LevelScore.ts,片段示例。依赖 Creator 3.8,须与上面的 score.ts 放在 assets/scripts 同一目录,并挂到一个启用组件的活动节点。
import { _decorator, Component } from 'cc';
import { scoreForLevel } from './score';
const { ccclass } = _decorator;
@ccclass('LevelScore')
export class LevelScore extends Component {
start(): void {
// 组件适配引擎时机,共享函数保持环境独立。
console.log(`level-score:${scoreForLevel(3)}`);
}
}预期结果:Inspector 中确认 LevelScore 已挂载,保存场景并预览,控制台输出 level-score:300。这个预期需要在真实 Creator 中验证,纯 TypeScript 例程运行成功只证明公式及模块依赖正确。
导入失败时先核对路径
若提示找不到模块,检查文件位置、大小写与相对路径。若提示没有导出成员,检查 score.ts 是否有对应的命名导出;不要把默认导出和命名导出混用。文件名相近但导入错误时,先沿编辑器跳转到定义确认实际引用来源。
避免模块顶层主动创建场景对象,也不要让 score.ts 反过来导入 LevelScore;双向依赖会使初始化时机难以判断。多文件入口可以用严格检查验证,引擎模块仍应从 cc 导入。模块规则依据 Cocos 3.8 模块规范 与 TypeScript 模块说明。