【免费下载链接】denon Monitor any changes in your Deno application and automatically restart.项目地址https://gitcode.com/gh_mirrors/de/denon点击查看免费下载denon是 Deno 生态中 nodemon 的替代品它监视你的 Deno 应用文件变化并自动重启进程。很多新手第一次使用 denon 时就会撞上command not found、权限拒绝PermissionDenied或改了文件却不重启的监视失效问题。这份排查清单覆盖 8 个高频坑点按顺序自查一遍基本能解决绝大多数 denon 故障。 排查前先做两件事定位问题范围运行denon --version确认命令本身能不能执行在项目目录直接运行denon不带参数它会列出配置里可用的脚本如果提示 you dont have any scripts问题大概率出在配置或路径上。坑点 1Deno 版本低于 1.6.0denon 装不上或行为异常症状安装 denon 时报错或安装后运行即崩溃原因denon 要求deno版本不低于^1.6.0旧版 deno 缺少 denon 依赖的 API解决先查看版本再升级deno --version deno upgrade官方安装流程见 docs/installation.md其中特别标注了版本要求。坑点 2command not found: denon最高频症状终端提示denon: command not found原因denon 通过deno install安装到~/.deno/bin目录但该目录不在系统PATH中解决bash / zshecho export PATH$HOME/.deno/bin:$PATH ~/.bashrc source ~/.bashrcWindows 用户需手动将%USERPROFILE%\.deno\bin加入系统 PATH。修改后用which denon验证命令可定位。这是官方 README 唯一收录在 FAQ 中的故障说明它是社区最高频问题。坑点 3权限拒绝——Required permissions read and run not granted症状denon启动后立即退出打印Required permissions read and run not granted原因denon 自身运行需要 3 个权限定义见 src/cli.tsread读取配置文件 监视文件变化write--init生成配置模板run以子进程方式执行你的脚本解决安装时带-A一次性授权deno install -qAfr --unstable https://deno.land/x/denon/denon.ts若之前已安装过未授权的版本用上述命令覆盖重装即可。坑点 4权限拒绝——子进程脚本报 PermissionDenied这个坑与坑点 3 不同denon 本身启动正常但它拉起的子进程报PermissionDenied。原因denon 只是把deno run ...包了一层你的脚本需要哪些权限仍要在 deno 层显式声明解决二选一命令行直接传参denon run --allow-env --allow-net app.ts在配置文件中用allow声明支持对象 / 数组两种写法{ scripts: { start: { cmd: deno run app.ts, allow: { read: /tmp, env: true } } } }完整写法可参考 README.md 的 Permissions 一节和 docs/usage.md。坑点 5配置文件找不到脚本列表为空症状denon start无法识别脚本或denon列出 0 个脚本原因denon 只按固定候选文件名列表按优先级顺序匹配查找配置自定义文件名不会生效。候选列表定义在 src/config.ts常见的有denon.json、scripts.json、denon.config.ts等 14 个排查三步确认文件名在候选列表内且是普通文件而不是目录JSON / YAML 语法错误时 denon 会静默降级为默认配置可用denon -c 你的配置文件显式指定看是否出现unsupported configuration警告使用 TS 配置.config.ts时import 失败会打印Error opening ts config检查模块路径是否可达可用 schema.json 为 JSON 配置做类型校验。坑点 6监视失效——改了文件却不重启反馈最多denon 默认只监视当前工作目录Deno.cwd()且所有变化都要通过 4 个过滤器paths、exts、match、skip选项定义见 src/watcher.ts文档见 docs/configuration/watcher.md。按以下顺序自查是否在正确目录启动在 A 目录启动 denonB 目录的文件变化不会触发重启paths是否覆盖了目标目录paths一旦配置就会替换默认的 cwd而不是追加skip/match的 glob 是否误伤默认skip为**/.git/**自定义 glob 少写**/前缀可能把所有文件都排除掉打开 debug 日志观察匹配过程{ logger: { debug: true } }denon 会逐条打印trying to match path逻辑在 src/watcher.ts能直接看出是哪个过滤器把文件挡掉了。官方还在 examples/ 目录保留了多个 issue 复现用例如 examples/issue_49/denon.json、issue_91、issue_101遇到疑难问题可对照其配置思路。坑点 7自定义扩展名不在默认监视列表原因默认exts只有ts、tsx、js、jsx、json五种默认值见 src/config.ts症状只修改.vue、.mjs、.ini等非默认扩展名文件时不重启解决在watcher.exts中补上扩展名不带点{ watcher: { exts: [ts, tsx, js, mjs, vue] } }另外若文件系统事件在 Windows / 网络共享盘上不可靠可加legacy: true切换为目录遍历walking算法代价是性能略低。坑点 8重启太频繁 / 报 EADDRINUSE 端口冲突症状每次自动重启都报EADDRINUSE: address already in use或 CPU 被反复重启打满原因denon 内置 350ms 防抖watcher.interval连续保存会触发多轮重启旧进程尚未释放端口新进程就起来抢端口缓解组合拳调大防抖窗口watcher: { interval: 800 }服务端代码开启SO_REUSEADDR允许新进程复用尚未完全释放的端口设置logger.fullscreen: true每次重启清屏方便观察真实输出避免误判为卡死。logger 的完整选项见 docs/configuration/logger.md。⚡ 8 大坑点速查表#典型症状关键排查点参考1安装失败 / 运行崩溃deno --version是否 ≥ 1.6.0installation.md2command not found~/.deno/bin是否在 PATHREADME.md FAQ3read and run not granted安装时加-A授权src/cli.ts4子进程PermissionDeniedallow配置 /--allow-*参数usage.md5脚本列表为空配置文件名必须在候选列表内src/config.ts6改文件不重启cwd / paths / match / skipwatcher.ts7特定扩展名不触发watcher.exts默认仅 5 种watcher.md8EADDRINUSE/ 重启风暴interval 端口复用logger.md 排查万能姿势denon -c 配置文件 start配合logger.debug: true。绝大多数玄学问题都能在 debug 日志里看到 denon 实际监视了哪些路径、执行了哪条命令。相关文档与源码路径配置总览与 FAQREADME.md安装指南docs/installation.mdCLI 用法docs/usage.mdWatcher 选项docs/configuration/watcher.mdLogger 选项docs/configuration/logger.md配置文件候选列表src/config.ts权限声明src/cli.ts监视过滤逻辑src/watcher.tsIssue 复现示例examples/issue_49/denon.json、examples/issue_101/scripts.json赞分享【免费下载链接】denon Monitor any changes in your Deno application and automatically restart.项目地址https://gitcode.com/gh_mirrors/de/denon点击查看免费下载相关推荐AutoPentestX常见问题排查清单安装失败、权限拒绝、报告生成报错的8大解决方案AutoPentestX常见问题排查清单安装失败、权限拒绝、报告生成报错的8大解决方案 AutoPentestX 是一款自动化的渗透测试与漏洞报告工具一条命RepoBrain安装失败command not found与LLM配置缺失的完整排查清单RepoBrain安装失败command not found与LLM配置缺失的完整排查清单 RepoBrain 是一个给代码库装大脑的 AI 问答引擎让人工智能RAGAI AgentMCP 服务开发工具告别Credentials not foundopencode-claude-auth 8大常见报错、排查清单与调试日志技巧告别Credentials not foundopencode claude auth 8大常见报错、排查清单与调试日志技巧 opencode claud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考