No such file or directory: requirements.txt

### 解决 `requirements.txt` 文件不存在的问题

当遇到 `No such file or directory: 'requirements.txt'` 错误时，通常是因为指定路径下的 `requirements.txt` 文件确实不存在或路径不正确。以下是几种可能的原因及解决方案：

#### 1. 确认文件是否存在
确保当前工作目录下确实存在名为 `requirements.txt` 的文件。可以通过命令行工具确认文件的存在。

ls -l requirements.txt

如果文件不在预期的位置，则需要调整路径参数以指向实际存在的文件位置[^1]。

#### 2. 正确使用相对路径与绝对路径
在调用 `pip install -r requirements.txt` 或其他涉及读取该文件的操作时，请确保提供了正确的相对路径或绝对路径。例如，如果是从项目的根目录运行命令而 `requirements.txt` 存在于子目录中，则应指明完整的相对路径如 `-r ./subdir/requirements.txt`[^3]。

#### 3. 验证虚拟环境中配置无误
对于使用了虚拟环境的情况，需注意激活相应的虚拟环境后再尝试安装操作，并且要保证所使用的 Python 可执行文件及其关联的开发包已正确安装并可用。这可以防止因缺少必要的编译器支持而导致找不到特定头文件等问题。

#### 4. 设置环境变量
有时也需要检查系统的 PATH 环境变量设置是否包含了 Python 和 pip 所必需的相关路径（特别是 Scripts 路径）。可以在 Windows 上通过系统属性中的高级选项来编辑这些环境变量；而对于 Linux/MacOS 用户来说，一般是在 shell 初始化脚本里完成这项工作的[^5]。

#### 5. 使用合适的工具生成 `requirements.txt`
为了避免手动创建过程中可能出现的人为失误，建议利用自动化工具来自动生成准确的依赖列表文件。比如可以先在一个干净的工作区中安装好所有的第三方库之后再导出它们作为 `requirements.txt`:

pip freeze > requirements.txt

或者借助专门用于此目的的小型实用程序如 `pipreqs` 来扫描源码树从而构建更精确的需求清单[^2]。