CLI 与 deno.json 速查
Deno 常用子命令、配置职责、tasks、imports 与排错顺序
命令映射
| 目标 | 命令 |
|---|---|
| 查看版本 / 帮助 | deno --version / deno help <command> |
| 初始化项目 | deno init / deno init --serve |
| 运行入口 | deno run [permissions] main.ts |
| 执行任务 | deno task <name> |
| 添加 / 删除依赖 | deno install <pkg> / deno uninstall <pkg> |
| CI 可复现安装 | deno ci / deno ci --prod |
| 依赖列表 / 审计 | deno list / deno audit |
| 查看模块图 | deno info main.ts |
| 格式化 / Lint | deno fmt / deno lint |
| 类型检查 | deno check main.ts |
| 测试 / 覆盖率 | deno test / deno test --coverage |
| 生成文档 | deno doc |
| 编译 / 打包 | deno compile / deno bundle |
| 构建桌面应用 | deno desktop（2.9+） |
| 部署到 Deno Deploy | deno deploy |
| 发布 JSR 包 | deno publish --dry-run / deno publish |
| 升级 Deno | deno upgrade |
最小配置
{
"tasks": {
"dev": "deno run --watch --allow-net --allow-env=PORT main.ts",
"check": "deno fmt --check && deno lint && deno check **/*.ts && deno test"
},
"imports": {
"@std/assert": "jsr:@std/assert@^1.0.0"
},
"lint": { "rules": { "tags": ["recommended"] } },
"fmt": { "lineWidth": 100 }
}
只添加从当前 deno.json reference 核对过、且项目需要的键。
排错顺序
- 输出
deno --version、OS 与架构。 - 确认实际命中的
deno.json(c)/ workspace 根；用deno info <entry>和deno task观察实际解析与任务，不猜配置合并结果。 - 查看
deno task和deno info <entry>，不要猜入口与解析图。 - 区分权限拒绝、模块解析、类型错误、运行时异常和平台错误。
- 制作最小复现，再查当前官方文档与 issue。
官方参考：CLI reference、deno.json。