已安装的node模块导入异常：Solidity编译正常但编辑器提示错误

问题根因 #

该问题属于编辑器Solidity语法校验插件的配置与项目实际编译配置不匹配导致的误报错：你的项目所用的Hardhat/Foundry/Truffle等编译工具已经正确识别OpenZeppelin依赖的本地路径，因此合约可以正常编译；但编辑器的Solidity校验插件未加载到对应的路径映射规则，因此误判导入路径不存在，弹出错误提示。

修复步骤 #

针对VSCode + Nomic Foundation官方Solidity插件（最常用场景） #

• 方案1（通用方案，适配所有框架）：
  1. 在项目根目录新建remappings.txt文件，根据依赖安装方式写入对应映射规则：
     • npm/yarn/pnpm安装：写入@openzeppelin/=node_modules/@openzeppelin/
     • Foundry安装：写入@openzeppelin/=lib/openzeppelin-contracts/
  2. 打开VSCode设置，搜索solidity.remappings，确认「Automatically load remappings from remappings.txt」选项已开启
  3. 打开任意Solidity文件，右键选择「Solidity: Restart Solidity Language Server」重启语言服务，报错即可消失
• 方案2（仅适配Hardhat框架）：
  1. 打开VSCode设置，搜索solidity.hardhat.enabled，开启该选项
  2. 重启Solidity语言服务，插件会自动读取Hardhat配置生成路径映射，无需手动编写映射规则

针对其他编辑器/其他Solidity插件 #

1. 找到插件的自定义路径映射配置项，手动添加OpenZeppelin导入前缀到本地实际安装路径的映射
2. 重启插件对应的语言服务即可

报错参考截图：

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