VS Code中Solidity扩展无法解析node_modules内依赖导入的技术求助

我的环境详情 #

• 环境配置：
  • 用nvm管理Node.js，可通过nvm use v16.17.0切换版本
  • 各Node环境都安装了Truffle
  • VS Code安装了Truffle for VS Code扩展（与Solidity扩展深度关联）
  • 已安装Ganache桌面应用
  • 某Node版本下通过npm安装了solcjs
• 合约代码：

// SPDX-License-Identifier: UNLICENSED
pragma solidity >=0.4.25 <0.9.0;
import "@openzeppelin/contracts/access/Ownable.sol";

contract CallerContract is Ownable {
}

• 项目结构（node_modules位于Truffle项目的上级目录）：

├── caller
│   ├── build
│   ├── contracts
│   ├── migrations
│   ├── test
│   └── truffle-config.js
├── oracle
│   ├── build
│   ├── contracts
│   ├── migrations
│   ├── test
│   └── truffle-config.js
├── node_modules
├── package-lock.json
├── package.json

正常与异常现象 #

• 正常情况：终端执行truffle compile在所有Node版本下都能成功编译；VS Code的Truffle合约浏览器功能也能正常编译合约。
• 问题现象：右键执行「Solidity: Compile Contract」时编译失败，报错信息如下：

Retrieving compiler information: Compiler using default compiler (embedded on extension), solidity version: 0.8.9+commit.e5eed63a.Emscripten.clang
ParserError: Source "@openzeppelin/contracts/access/Ownable.sol" not found: File import callback not supported
--> path to contracts/contracts/CallerContract.sol:7:1:
|
| import "@openzeppelin/contracts/access/Ownable.sol";
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Compilation failed with 1 errors

已尝试但无效的方案 #

修改VS Code配置：

"solidity.packageDefaultDependenciesContractsDirectory": "",
"solidity.packageDefaultDependenciesDirectory": "node_modules"

有效解决方案 #

1. 添加Solidity重映射配置

因为你的node_modules在项目的上级目录，Solidity扩展默认只会在当前项目根目录查找依赖，所以需要通过重映射明确指定依赖路径。在项目的.vscode/settings.json中添加：

"solidity.remappings": [
    "@openzeppelin/=../node_modules/@openzeppelin/"
]

这个配置会告诉Solidity扩展：当遇到@openzeppelin/开头的导入语句时，去上级目录的node_modules里寻找对应的合约文件。

2. 切换扩展使用本地编译器

报错显示当前使用的是扩展内嵌的编译器，你可以切换为使用项目本地安装的solc，它会自动识别上级目录的依赖：

• 打开VS Code设置（快捷键Ctrl+,/Cmd+,）
• 搜索「Solidity: Default Compiler」，选择localNodeModule选项
• 或者搜索「Solidity: Compile Using Remote Version」，留空或选择你本地安装的solc版本

这样扩展会调用你项目中安装的solc，而非自带的编译器，就能正确定位到上级目录的node_modules了。

3. 本地安装依赖（可选）

如果不想修改配置，也可以在caller和oracle各自的目录下执行：

npm install @openzeppelin/contracts

将OpenZeppelin依赖安装到每个项目的本地目录，这样扩展就能直接在项目根目录的node_modules中找到文件，不过会产生重复的依赖文件。

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