vue3+vite解决类型弃用警告npm warn deprecated @types/xlsx@0.0.36: This is a stub types definition for xlsx
使用 npm install 安装,报警:
npm warn deprecated @types/xlsx@0.0.36: This is a stub types definition for xlsx (https://github.com/sheetjs/js-xlsx). xlsx provides its own type definitions, so you don't need @types/xlsx installed!

你在 Vue3 + Vite 项目中使用 xlsx 时遇到的 @types/xlsx 弃用警告,是因为 xlsx 库从某个版本开始自己内置了类型定义文件(TypeScript declarations),不再需要单独安装 @types/xlsx 这个包了。这个警告提醒你移除多余的依赖。
🔧 如何解决
-
卸载
@types/xlsx:既然不再需要,就卸载它。bash
npm uninstall @types/xlsx
-
确保安装了正确的
xlsx库:如果你还没有安装xlsx本身,或者想确认版本,可以执行:bash
# 如果尚未安装 xlsx,可以安装它 npm install xlsx # 或者指定一个已知稳定的版本(例如文档或社区推荐的) # npm install xlsx@0.18.5 # 此处版本号请查阅官方仓库或根据项目兼容性选择
-
注意:搜索结果中提到,在某些情况下(如 Vue 环境),使用
xlsx的 0.16.0 版本可能兼容性更好。但通常建议尝试最新稳定版,若遇问题再考虑调整版本。
-
-
检查你的代码导入:确保代码中是从
xlsx导入,而不是尝试从@types/xlsx导入。javascript
// 正确的导入方式 import * as XLSX from 'xlsx'; // 或者根据模块导出方式 // import { read, writeFileXLSX } from 'xlsx'; -
清理构建缓存(可选):如果问题依然存在,可以尝试清理 npm 缓存和项目依赖重装。
bash
npm cache clean --force rm -rf node_modules npm install
⚠️ 其他注意事项
-
如果你在项目中使用了类似
xlsx-style:cite[2] 或xlsx-style-vite这类用于样式处理的库,请注意它们可能需要额外的配置,例如在vue.config.js中设置externals:cite[4]:javascript
// vue.config.js module.exports = { chainWebpack: (config) => { config.externals({ './cptable': 'var cptable' }); } };但这通常与你现在遇到的
@types/xlsx弃用警告无直接关联。 -
始终确保你安装的 npm 包(包括
xlsx)与你的 Node.js 版本兼容。
💎 总结
移除不再需要的 @types/xlsx 依赖,并确保正确安装了 xlsx 库本身,这个警告就能解决。这是一个无害的提醒,目的是让你的项目依赖更清晰。
卸载 @types/xlsx
npm uninstall @types/xlsx
卸载后,package.json 的开发依赖就会删除 "@types/xlsx":"^0.0.036" 这行代码了

更多推荐


所有评论(0)