已安装solc编译器，为何solcx及VS Code无法识别？

问题背景 #

已通过以下方式安装solcx和Solidity编译器：

pip install py-solc-x

sudo add-apt-repository ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install solc

系统终端执行solc --version可正常返回版本信息：solc, the solidity compiler commandline interface Version: 0.8.18+commit.87f61d96.Linux.g++，which solc显示路径为/usr/bin/solc。但VS Code终端执行solc提示bash: solc: command not found，运行Python编译代码时出现错误：

which: no solc in (/home/{USER}/Desktop/Ethernaut/venv/bin:/home/{USER}/.nvm/versions/node/v19.3.0/bin:/app/bin:/app/bin:/app/bin:/usr/bin:/home/{USER}/.var/app/com.visualstudio.code/data/node_modules/bin:/home/{USER}/.foundry/bin)

修改/usr/bin下solc二进制文件的所有者后问题仍未解决。

解决方案 #

方案1：从系统终端启动VS Code

打开系统终端，执行code命令启动VS Code，此时VS Code会继承终端的完整环境变量，可正确识别/usr/bin下的solc。启动后在VS Code终端执行solc --version验证是否恢复正常。

方案2：配置VS Code终端的环境变量

若不想每次从终端启动，可通过修改VS Code的settings.json手动补全PATH：

1. 按Ctrl+Shift+P打开命令面板，输入Open Settings (JSON)并回车。
2. 在settings.json中添加以下配置：

"terminal.integrated.env.linux": {
    "PATH": "/usr/bin:$PATH"
}

3. 重启VS Code终端，执行solc --version测试。

方案3：在Python代码中手动指定solc路径

绕过环境变量限制，直接在代码里指定solc的绝对路径：

from solcx import set_solc_version, compile_files
import os

# 方法1：使用set_solc_version指定路径
set_solc_version("/usr/bin/solc")

# 方法2：设置SOLC_BINARY环境变量（二选一即可）
# os.environ["SOLC_BINARY"] = "/usr/bin/solc"

compiled_contract = compile_files([{"path": filename, "content": contract_source_code}])

问题原因 #

从路径/home/{USER}/.var/app/com.visualstudio.code可判断你使用的是Flatpak版本的VS Code，它运行在沙箱环境中，默认环境变量未正确加载系统全局的PATH配置，导致即使PATH中包含/usr/bin，沙箱内也无法正常访问该路径下的solc。从终端启动或手动指定路径可绕过沙箱的环境限制。

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