pythonxxx.py和python-mxxx两种执行方式的使用场景和问题解决

Written by

in

文章目录
  • 目录
    • 一、直接运行脚本方式(python script.py)
      • 工作原理
      • 导入机制
      • 示例
    • 二、模块方式运行(python -m module)
      • 工作原理
      • 导入机制
      • 示例
    • 三、两种方式的适用场景
      • 直接运行方式适用于:
      • 模块方式适用于:
    • 四、解决导入问题的方法
      • 对于直接运行方式:
      • 对于模块方式:
    • 五、总结与最佳实践
      • 直接运行方式
      • 模块方式
      • 最佳实践

    当你使用 python script.py 直接运行脚本时:

    1. Python解释器将脚本所在的 目录 添加到 sys.path 的 第一位
    2. 脚本被作为 main 模块执行
    3. 导入搜索从脚本所在目录开始,然后是Python标准库路径和已安装包路径

    • 当脚本中有 import xxx 语句时,Python会首先在脚本所在目录查找 xxx.py
    • 如果找不到,才会去系统路径中查找
    • 相对导入(如 from . import xxx )在直接运行的脚本中 不起作用 ,因为脚本被视为顶级模块

    当你运行 python online/ods/zs/ods_game_role_transfer_analysis_baoliang_fix_df.py 时:

    • sys.path[0] 被设置为 online/ods/zs/
    • import utils.aiform_util 会在 online/ods/zs/utils/ 下查找,而不是项目根目录的 utils/

    当你使用 python -m module 运行模块时:

    1. Python解释器将 当前工作目录 添加到 sys.path 的第一位
    2. 按照模块导入规则查找并加载指定模块
    3. 将该模块作为 main 执行

    • 导入搜索从当前工作目录开始
    • 模块路径使用点号(.)分隔,而不是斜杠(/)
    • 相对导入在这种模式下可以正常工作
    • 包内的 init.py 文件会被正确加载

    当你运行 python -m online.ods.zs.ods_game_role_transfer_analysis_baoliang_fix_df 时:

    • sys.path[0] 被设置为当前工作目录(通常是项目根目录)
    • import utils.aiform_util 会在项目根目录的 utils/ 下查找,这符合项目结构

    • 独立脚本,不依赖项目结构
    • 简单的单文件程序
    • 临时测试或调试单个文件
    • 脚本中使用绝对导入或已添加系统路径的情况

    • 大型项目中的模块化代码
    • 有复杂导入关系的项目
    • 使用相对导入的代码
    • 需要保持包结构完整性的情况
    • 生产环境部署

    1. 添加项目根目录到系统路径 :

    import sys import os sys.path.insert(0, os.path.abspath(os.path.join (os.path.dirname(__file__), '../../../')))

    1. 使用绝对导入 :明确指定完整导入路径

    from develop_python.utils.aiform_util import fetch_all_records

    1. 创建环境变量 :设置 PYTHONPATH 包含项目根目录

    1. 正确使用点号 : python -m online.ods.zs.module_name (不带 .py )
    2. 确保工作目录正确 :先 cd 到项目根目录
    3. 确保包结构完整 :每个目录都有 init.py 文件

    • 优点 :简单直观,命令简短
    • 缺点 :容易出现导入问题,不尊重包结构
    • 适用 :简单脚本、快速测试

    • 优点 :尊重Python的模块系统,导入更可靠,适合复杂项目
    • 缺点 :命令较长,需要理解模块路径
    • 适用 :生产环境、复杂项目、团队协作

    1. 生产环境优先使用模块方式 : python -m online.ods.zs.module_name
    2. 保持一致的项目结构 :确保每个包都有 init.py
    3. 在项目根目录运行命令 :避免路径混淆
    4. 使用虚拟环境 :隔离项目依赖
    5. 编写可导入的代码 :即使是脚本也应考虑被导入的情况

    到此这篇关于python xxx.py 和 python -m xxx两种执行方式的使用场景和问题解决的文章就介绍到这了,更多相关python xxx.py 和 python -m xxx 执行内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客!

    您可能感兴趣的文章:

    • pycharm运行程序时出现Run‘python tests for XXX.py‘问题及解决
    • python -m pip install xxx和pip install xxx的区别

    站内搜索