如何在Bash脚本中运行Python代码并修复ModuleNotFoundError报错

• 运行环境：MacOS
• 正常运行场景：进入Python代码所在文件夹后，执行python mycode.py无报错，代码运行正常
• 自定义脚本尝试：为实现任意路径下可运行代码，编写Bash脚本run_my_code，初始内容如下：

cd /path/to/my/folder
echo $PYTHONPATH
echo $PATH
pip list
pwd
python mycode.py

• 故障现象：在任意路径下执行run_my_code命令时，触发ModuleNotFoundError报错
• 已排查确认项：
  • 两种运行场景下PYTHONPATH、PATH环境变量输出完全一致
  • pip list返回的已安装模块列表完全一致
  • 报错提示缺失的模块，明确出现在已安装模块列表中
• 诉求：需要标准、合规的路径/模块报错修复方案，替换当前使用的非规范临时解决方法

核心原因是非交互Shell执行脚本时，Python模块检索逻辑和手动在交互终端执行存在隐式差异：
手动进入目录执行命令属于交互Shell场景，Python启动时会自动加载当前工作目录、交互Shell配置的别名/软链接/环境规则；脚本运行属于非交互Shell场景，即使脚本内写了cd切换目录，也可能出现解释器指向偏差、本地模块路径未被纳入搜索范围、交互层配置未加载等问题，最终导致模块检索失败。这类隐式差异不会体现在PATH、PYTHONPATH、pip list的表层输出上，常规排查很难定位。

按推荐优先级从高到低排列：

方案1：显式指定路径与解释器（改动最小，适配单脚本场景） #

直接修改run_my_code脚本，去掉所有隐式依赖的逻辑，所有路径、解释器都用明确值，修改后内容如下：

#!/bin/bash
# 定义代码目录绝对路径，cd失败直接退出，避免后续逻辑在错误路径执行
CODE_DIR="/path/to/my/folder"
cd "$CODE_DIR" || exit 1

# 显式将代码根目录加入Python模块搜索路径最高优先级
export PYTHONPATH="$CODE_DIR:$PYTHONPATH"

# 注意：先在能正常运行代码的交互终端执行`which python`，拿到输出的绝对路径替换下面的解释器路径
# 不要直接写`python`，避免非交互Shell下解释器指向偏差
/your/actual/python/absolute/path mycode.py

修改后给脚本加可执行权限：chmod +x run_my_code，把脚本移动到PATH包含的标准目录（比如/usr/local/bin）即可全局调用。

方案2：安装为可编辑Python包（适合长期维护的项目，最符合Python规范） #

如果代码是长期维护的项目，不要依赖目录路径、PYTHONPATH的临时配置，直接把项目做成可安装的包：

1. 在代码根目录（即/path/to/my/folder下）新建pyproject.toml文件，写入最小配置：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "my_personal_code"
version = "0.0.1"

2. 在能正常运行代码的交互终端里，进入代码目录执行python -m pip install -e .，以可编辑模式把项目安装到当前Python环境中
   安装完成后，不管在什么路径下，只要调用对应Python解释器执行脚本，都能正常检索到所有模块，脚本里不需要再写cd、改PYTHONPATH的逻辑。

必看避坑项 #

• 脚本里不要直接调用pip，如果需要检查包列表，用/your/actual/python/absolute/path -m pip list，保证pip和调用的Python解释器完全对应，避免pip指向其他环境的包目录
• 不要靠Shell别名调用脚本或者Python解释器，非交互Shell默认不会加载.zshrc/.bashrc里配置的别名
• 如果使用venv、conda、pyenv等管理Python版本，脚本里必须直接写对应环境下Python解释器的绝对路径，不要依赖Shell自动激活环境的逻辑

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