在AWS构建项目时遇TS2694错误：fs无EncodingOption成员

核心原因 #

你遇到的问题是**@types/fs-extra版本与实际安装的fs-extra版本不兼容**：

• 安装的@types/fs-extra@^11.0.4是为fs-extra@11.x+编写的类型定义，其中引用了Node.js fs模块的EncodingOption类型
• 但生产依赖是fs-extra@10.1.0，这个版本的类型依赖与@types/fs-extra@11.x不匹配，导致类型校验失败

两种解决办法 #

办法1：降级@types/fs-extra到匹配版本 #

卸载当前不兼容的类型包，安装与fs-extra@10.1.0对应的类型版本：

# 卸载旧的类型包
npm uninstall @types/fs-extra --save-dev
# 安装匹配的10.x版本类型
npm install @types/fs-extra@^10.0.0 --save-dev

如果使用yarn：

yarn remove @types/fs-extra --dev
yarn add @types/fs-extra@^10.0.0 --dev

办法2：升级fs-extra到兼容版本 #

如果项目允许升级fs-extra，直接把生产依赖的fs-extra升级到11.x及以上版本，与@types/fs-extra版本匹配：

npm install fs-extra@^11.0.0 --save

或yarn：

yarn add fs-extra@^11.0.0

额外检查 #

确保你的@types/node版本与Node.js 20.1.1匹配（建议安装@types/node@^20.0.0），避免fs模块的类型定义出现版本差异。

内容的提问来源于stack exchange，提问作者codeflinger