脚本运行报错90%以上源于环境未激活、路径错误或python解释器不符；应先用conda activate激活目标环境，再确认当前目录和解释器路径，最后检查包是否安装在该环境中。
脚本运行报错，90% 以上不是代码问题，而是环境没激活、路径没对上、或者 Python 解释器根本不是你预期的那个。
为什么 python xxx.py 报错说找不到文件或模块？
常见现象：No module named 'pandas'、can't open file 'train.py': [Errno 2] No such file or directory、ImportError: cannot import name 'xxx' from partially initialized module。
根本原因不是包没装，而是当前 shell 没在正确的 conda 环境里，或者你在错误的目录下执行了命令。
- 用
conda activate myenv激活环境后，再运行python script.py—— 不要跳过这步 - 检查当前路径：
pwd（mac/Linux）或cd（Windows），确保script.py真的在当前目录下 - 别在 VS Code 终端里「以为」激活了环境，实际可能还是系统默认 Python：运行
which python（mac/Linux）或where python（Windows）确认解释器路径 - 如果用相对路径导入（如
from src.utils import helper），得确保当前工作目录是项目根目录，不是src/目录下
为什么明明装了包，却提示 No module named xxx？
最常踩的坑：你在 base 环境里装了包，但脚本是在 myproject 环境里跑的；或者用 pip install 装到了系统 Python，而 conda 激活的是另一个环境。
- 先确认当前环境：
conda info --envs和conda env list查看所有环境，conda activate myenv显式激活目标环境 - 再确认包是否真在里面：
conda list | grep pandas或pip list | grep torch—— 注意，conda list和pip list输出可能不同，优先信conda list（除非你明确用 pip 装过） - 别混用
conda install和pip install在同一个环境里，尤其不要用 pip 装 conda 已管理的包（如 numpy、scipy），容易破坏依赖 - 如果必须用 pip，先确保在正确环境里：
conda activate myenv→python -m pip install xxx（比裸写pip install更可靠）
为什么 conda run -n myenv python script.py 还是失败？
这个命令看似绕过激活步骤，实际有隐藏陷阱：它不会加载该环境的 site-packages 路径，也不读取环境变量（比如 PYTHONPATH），更不处理相对导入路径。
- 它只保证用
myenv的python.exe执行，但不等价于手动conda activate后运行 - 如果你的脚本依赖
os.environ里的自定义变量，或需要sys.path包含项目根目录，conda run默认不提供这些 - 真正安全的做法永远是：
conda activate myenv && python script.py（Windows 下用&分隔） - 自动化脚本里要用
conda activate，就得先初始化 shell：conda init powershell（PowerShell）或conda init bash（Linux/macOS），否则activate命令不可用
复杂点在于：错误信息从不告诉你「你当前不在哪个环境」，它只说「模块不存在」或「文件找不到」。所以排查顺序永远是——先确认环境，再确认路径，最后才看代码本身。漏掉前两步，修三天也白搭。
