使用Foundry安装Solidity依赖失败：无法识别OpenZeppelin依赖

问题原因 #

你合约里用的是@openzeppelin/contracts/...这种导入路径，但remapping配置里写的是openzeppelin-contracts/=lib/openzeppelin/contracts/，两者不匹配导致Foundry找不到依赖文件。另外注意，用forge install openzeppelin/openzeppelin-contracts安装后，依赖默认存放在lib/openzeppelin-contracts目录，不是lib/openzeppelin，你的路径也写错了。

修复步骤 #

• 修改remapping.txt配置
  把文件里的映射内容改成：

@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/

• 验证映射是否生效
  执行命令：

forge remappings

确认输出结果里包含@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/这一行。

• 重新构建合约
  运行命令：

forge build

额外排查点 #

如果还是构建失败，先检查lib/openzeppelin-contracts文件夹是否存在，要是没有就重新执行forge install openzeppelin/openzeppelin-contracts；另外合约里的Solidity版本^0.8.4和OpenZeppelin v4.x系列完全兼容，不用调整版本。

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