### 解决 Python 在 CMD 中运行脚本时报 ModuleNotFoundError 的问题 当在 Windows 命令行 (CMD) 中执行 Python 脚本时，可能会遇到 `ModuleNotFoundError` 错误。这种错误通常发生在导入模块时，Python 无法找到指定的模块。以下是可能的原因以及解决方案： #### 1. **原因分析** - 当前工作目录不在 Python 的模块搜索路径 (`sys.path`) 中[^2]。 - 使用了相对路径导入模块而不是绝对路径[^4]。 - 第三方库未安装或环境变量配置不正确[^5]。 --- #### 2. **解决方案** ##### 方法一：修改 `sys.path` 可以通过动态调整 `sys.path` 来确保 Python 能够找到所需的模块。以下是一个通用代码片段，可以将其添加到脚本开头以解决问题： ```python import sys import os cur_path = os.path.abspath(os.path.dirname(__file__)) root_path = os.path.split(cur_path)[0] sys.path.append(root_path) ``` 这段代码的作用是将当前脚本所在的根目录加入到 `sys.path` 中，从而让 Python 能够正确解析模块路径[^3]。 ##### 方法二：设置正确的虚拟环境 如果使用的是第三方库（如 `requests`），需要确认这些库已正确安装并位于当前使用的 Python 环境中。可以在 CMD 中运行以下命令来验证： ```bash pip list ``` 如果没有发现所需库，则需重新安装它们： ```bash pip install requests ``` 另外，在 PyCharm 和 CMD 中切换可能导致不同的 Python 环境被调用。建议显式激活目标虚拟环境后再运行脚本。例如： ```bash path\to\venv\Scripts\activate python your_script.py ``` ##### 方法三：扩展 `sys.path` 到特定目录 对于涉及多个子模块的情况，可以直接向 `sys.path` 添加具体路径。例如： ```python sys.path.extend([ 'E:\\gitlab', 'E:/gitlab/queryDataFromArchery' ]) ``` 这样能够有效避免因路径缺失而导致的模块加载失败问题。 ##### 方法四：检查依赖关系 有时，某些模块之间的相互依赖也会引发此问题。因此，应仔细审查项目的结构设计，尤其是自定义模块间的引用方式。推荐始终采用基于项目根目录的绝对路径而非相对路径进行导包操作。 --- ### 总结 为了彻底解决 `ModuleNotFoundError` 问题，可以从以下几个方面入手： 1. 动态更新 `sys.path`； 2. 验证并修复 Python 环境及其对应的第三方库状态； 3. 显式声明所有必要的模块查找位置； 4. 审视整个应用架构中的依赖链条是否存在隐患。 只要按照上述指导完成相应修正措施，基本都能顺利排除该异常状况。 ---