功能特性
JSON 内容输入
提供内置的代码编辑器,支持直接粘贴 package.json 的 JSON 内容进行检查。编辑器带有语法高亮和错误提示功能,当 JSON 格式有误时会即时标注错误位置。还提供"加载示例"按钮一键填充示例 package.json 内容,以及"加载问题示例"按钮展示常见错误案例。"清空"按钮可以快速清除编辑器内容以便粘贴新的内容。
文件上传功能
支持拖拽上传和点击选择上传两种方式。直接将本地的 package.json 文件拖放到上传区域,或点击区域选择文件,工具会自动读取文件内容并填充到编辑器中。上传过程完全在浏览器本地完成,文件内容不会发送到任何远程服务器,确保了项目配置数据的隐私安全。支持所有主流浏览器的文件 API。
一键验证按钮
点击"验证"按钮即可触发完整的 package.json 检查流程。检查过程包括 JSON 语法解析、字段存在性检测、字段格式验证、依赖版本号校验、脚本配置审查等多个步骤。整个检查过程在毫秒级完成,结果即时显示在下方的结果面板中。支持重复验证,每次点击都会重新执行完整检查。
结果统计计数
检查完成后,顶部会显示三个醒目的统计数字:错误数量(红色)、警告数量(橙色)和通过数量(绿色)。这些统计帮助开发者快速了解 package.json 的整体质量状况。错误数量为零表示文件可以通过基本的发布验证,警告数量为零则表示文件符合最佳实践。开发者可以据此决定是否需要立即修复问题。
详细检查报告
以列表形式展示每个检查项的详细结果。每个检查项包含:字段名称、检查状态(通过/警告/错误)、详细描述和修复建议。开发者可以清楚地看到哪些字段通过了检查、哪些需要修改以及如何修改。对于错误级别的问题,还会标注具体的错误原因和位置信息,帮助开发者快速定位和修复。
已验证字段清单
工具会逐一验证以下字段:name(项目名称规范)、version(语义化版本号格式)、description(项目描述是否存在)、license(许可证标识)、author(作者信息)、repository(仓库地址)、main(入口文件路径)、scripts(脚本命令配置)、dependencies(生产依赖)、devDependencies(开发依赖)、engines(Node.js 版本要求)、keywords(关键词列表)。每个字段都有独立的验证逻辑和详细说明。
UD5工具箱