用 Extension.js 开发 Deno 项目

​

用 Deno 创建项目

deno run -A npm:extension@latest create my-extension --template=react

cd my-extension
deno task dev

​

主模式：deno.jsonc 就是项目清单

• 模板的依赖会以 npm: 说明符的形式进入 imports，由 deno install 负责解析。
• extension 引擎本身也声明在那里，形式为 npm:extension@<version>。
• nodeModulesDir 被设为 "auto"，因此 npm: 依赖会落到一个真实的 node_modules 目录里。打包器在 dev 和 build 时都从那里解析项目依赖。
• deno task <name> 也会在 node_modules/.bin 中查找可执行文件，所以生成的任务运行的是本地安装的 Extension.js CLI。

{
  "imports": {
    "react": "npm:react@^19.0.0",
    "react-dom": "npm:react-dom@^19.0.0",
    "extension": "npm:extension@^4.0.0"
  },
  "nodeModulesDir": "auto",
  "tasks": {
    "dev": "extension dev",
    "build": "extension build"
  }
}

​

伴随模式：deno.jsonc 与 package.json 并存

​

工具链如何检测 Deno

• Extension.js 在扫描项目依赖时会读取 deno.jsonc 或 deno.json。框架、CSS 和 TypeScript 的检测都能看到 imports 通过 npm: 说明符声明的包。
• 当两份清单声明了同一个包时，以 package.json 中的条目为准。
• 一个项目被视为由 Deno 管理，需要它有 deno.lock，或者有一份 Deno 配置且旁边没有 package.json。对混合项目来说，npm 家族的锁文件优先；而且只有当 deno 可执行文件在你的 PATH 上时，才会认定为 Deno。

​

Deno 项目中的 TypeScript

​

下一步

• 了解 Extension.js 如何处理 Node API。
• 了解如何管理 扩展配置。