使用-m参数运行Python包my_package时，如何避免调用同目录下的my_package.py？

这个问题的核心是Python模块搜索路径的优先级问题——当你用python -m my_package时，当前工作目录默认排在sys.path的最前面，所以Python先找到了你源码目录里的my_package/my_package.py，而不是虚拟环境中已经安装的my_package包。除了重命名文件，这里有几个更优雅的解决方案：

1. 使用隔离模式（-I参数） #

Python的-I启动参数会开启隔离模式，此时当前工作目录不会被添加到模块搜索路径中，同时会忽略用户级别的site-packages，但虚拟环境自身的site-packages依然会被加载。这个方法最简单，不需要修改脚本以外的内容：

#!/bin/bash
/path/to/myenv/bin/python -I -m my_package

测试时可以先跑/path/to/myenv/bin/python -I -c "import sys; print(sys.path)"，确认当前目录不在路径里，这样就能确保Python只会从虚拟环境中查找my_package。

2. 临时切换工作目录 #

在调用Python之前，切换到一个和你的源码目录无关的路径（比如虚拟环境的根目录或者临时目录），这样当前目录就不会出现在sys.path里干扰搜索：

#!/bin/bash
# 切换到虚拟环境目录，找不到就退出
cd /path/to/myenv || exit 1
/path/to/myenv/bin/python -m my_package

如果不想改变脚本执行后的工作目录，可以用pushd和popd临时切换：

#!/bin/bash
# 临时切换目录，屏蔽输出
pushd /path/to/myenv > /dev/null || exit 1
/path/to/myenv/bin/python -m my_package
# 切回原目录
popd > /dev/null

3. 调整PYTHONPATH优先级 #

把虚拟环境的site-packages目录放到PYTHONPATH的最前面，让Python优先从这里查找包，而不是当前目录。首先找到你的虚拟环境site-packages路径（通常是/path/to/myenv/lib/pythonX.Y/site-packages，X.Y是你的Python版本，比如3.10），然后修改脚本：

#!/bin/bash
# 替换成你实际的site-packages路径
export PYTHONPATH="/path/to/myenv/lib/python3.10/site-packages:$PYTHONPATH"
/path/to/myenv/bin/python -m my_package

这个方法的好处是不需要切换目录，但需要你确认site-packages的准确路径。

4. 调整包结构（轻量修改代码） #

如果不想动脚本，可以调整包内的文件职责：

• 把my_package.py里的核心逻辑迁移到__init__.py或者其他文件（比如core.py）中
• 确保__main__.py作为包的入口（本来它就是-m调用时的执行入口）
  这样当用-m my_package时，Python会优先加载包的__main__.py，而不是去执行my_package.py。不过这个方法本质上是调整代码结构，虽然不用重命名文件，但需要改动代码逻辑。

总结 #

最推荐的是隔离模式（-I参数）或者临时切换工作目录，这两个方法不需要修改代码，操作简单且能彻底解决优先级问题。

内容的提问来源于stack exchange，提问作者Ray P.