用途:指导在 TypeScript 项目中正确区分 dependencies 与 devDependencies。核心规则是 TypeScript 与 @types 包属于开发工具,运行时不存在,应安装为 devDependencies。
主要能力:识别 package.json 中把 typescript、@types/node、@types/react 等误放入 dependencies 的问题;给出正确配置示例,将 typescript 与 @types 放入 devDependencies,运行时库如 react 放入 dependencies;发布库时区分 dependencies、devDependencies 与 peerDependencies。
使用方式:安装 TypeScript 用 npm install --save-dev typescript;安装运行时库用 npm install react,其类型用 npm install --save-dev @types/react;Node 内置类型用 npm install --save-dev @types/node。检查可用 npm list --prod、npm list --dev、npm ls typescript @types/*,发布前用 npm pack 查看内容。
适用场景:新建 TypeScript 项目、安装 @types 包、配置 package.json、发布 TypeScript 库、管理项目依赖。
限制与说明:资料未提供具体版本兼容策略、其他包管理器用法或自动化校验工具;仅强调 TypeScript 编译后类型消失、@types 只含 .d.ts 无运行时代码,故应排除于生产依赖。