管理脚本

JavaScript 代码以 .js 或 .mjs 脚本资源保存在项目资源面板，与模型、纹理、材质相同。合理管理有助于清晰高效的流程。本页介绍创建、整理、删除、导入和分配。

核心概念：

• Script Asset：包含源码的 .js 或 .mjs 文件。
• Script Component：附加到实体的一组脚本实例，让脚本在该实体上运行。

创建脚本

直接在编辑器中创建：

1. 打开资源面板。
2. 建议先选择文件夹，可右键 New Asset > Folder 新建。
3. 创建脚本：
   • 在目标文件夹或资源根目录右键。
   • 选择 New Asset > Script。
     
   • 在弹窗中输入文件名。

提示

扩展名决定类型：无扩展名或 .js 创建经典脚本，.mjs（如 PlayerController.mjs）创建现代 ESM。新项目推荐 ESM，见 ESM 脚本。

导入脚本

可从外部导入：

• 从本机导入：
  1. 找到 .js 或 .mjs。
  2. 从文件管理器拖入资源面板目标文件夹。
  3. 编辑器上传并处理为脚本资源。
• 从资源商店导入：
  1. 通过资源面板顶部按钮打开资源商店。
  2. 浏览或使用 SCRIPT 筛选。
  3. 打开所需脚本或资源包详情，点击 IMPORT。
  4. 脚本通常位于以资源包命名的新文件夹内，之后可像普通资源一样管理。

通过 Script 组件分配给实体

脚本资源本身不会运行，必须通过 Script 组件附加到实体。

1. 选择实体：在层级面板选中目标。
2. 添加 Script 组件，如果还没有：
   • Inspector 点击 Add Component。
   • 选择 Script。
3. 分配脚本：
   • 点击组件中的 + ADD SCRIPT 输入框。
   • 在下拉搜索框输入脚本名，或浏览并选择。
   • 一个组件可添加多个脚本，initialize、update 等通常按 Scripts 列表顺序执行；跨依赖更适合使用 postInitialize 或事件。

备注

列表使用代码中的注册名，由 static scriptName 或经典脚本 pc.createScript('name') 指定，可能不同于文件名。见脚本面板控件。

整理脚本

项目变大时，应注意：

• 文件夹：按类别分组，可在文件夹之间拖动。
• 命名约定：保持一致且描述明确，便于查找理解。

删除脚本

操作步骤：

1. 在资源面板选中脚本。
2. 按 Delete，或右键 Delete。
3. 在对话框点击 DELETE 确认。

备注

若脚本已分配给场景实体，删除资源会从对应 Script 组件移除它；不再需要的空组件也可删除。

注意

资源删除无法撤销。建议使用版本控制定期创建检查点，以便恢复误删文件。