Ubuntu下Python3.8运行脚本找不到PATH中的riscv32-unknown-elf-objdump命令

注意：你提到的sys.path是Python用于导入第三方模块的搜索路径，和系统查找可执行文件的PATH环境变量完全无关，不要混淆二者。你的脚本头部#!/usr/bin/env python38的写法本身没有语法问题，它的作用是从当前运行上下文的PATH中查找名为python38的解释器，问题出在找到的python38解释器的运行环境和你直接执行python3时的环境不一致。

排查步骤 #

• 第一步：确认python38解释器执行时的实际PATH环境变量
  在报错的脚本最开头加入以下测试代码：

  import os
  print(os.environ.get("PATH"))
  

  直接用./your_script.py（走python38解释器）运行脚本，对比直接在shell执行echo $PATH的输出，确认riscv32工具所在的目录是否在脚本打印的PATH中不存在。
• 第二步：排查python38解释器的环境变量继承异常
  你遇到的问题90%以上是因为python38是通过snap/flatpak这类沙箱容器化方式安装的，这类安装方式会默认隔离宿主的环境变量，你手动加到shell配置（.bashrc/.zshrc）的PATH不会被沙箱内的python38读取。
  验证方法：分别执行which python3和which python38，查看python38的路径是否在/snap/或者/var/lib/flatpak/这类容器安装目录下。
• 第三步：验证subprocess调用逻辑兼容性
  给subprocess.run临时加shell=True参数测试，如果加了之后能正常找到命令，即可100%确认是PATH环境变量继承的问题，不是Python版本的语法兼容问题。注意测试完要把shell=True去掉，避免引入命令注入风险。

解决方案 #

• 方案1：修复python38的环境变量继承
  如果是snap安装的python38，可以重新安装时关闭环境隔离，或者直接把riscv32工具的路径加到全局环境变量/etc/environment中，重启系统后所有进程都能读取到该路径。
• 方案2：直接使用命令的绝对路径（最稳妥）
  先在shell执行which riscv32-unknown-elf-objdump拿到完整路径，比如返回结果为/opt/riscv/bin/riscv32-unknown-elf-objdump，直接把完整路径替换subprocess里的命令即可：

  result = subprocess.run(["/opt/riscv/bin/riscv32-unknown-elf-objdump", "-S", "-M", "numeric", exe_file], stdout=subprocess.PIPE, stderr=subprocess.PIPE, encoding="ASCII")
  

  该方案不受任何环境变量配置的影响。
• 方案3：重新安装非容器化的python38
  卸载当前的snap/flatpak版python38，通过deadsnakes PPA源安装原生的python38，原生安装的解释器会完整继承shell的环境变量，不会出现环境隔离问题。

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