跳转至

Python 算法中的第三方包

在构建基于 Python 的 cBot、指标或 cTrader 插件时,您可能需要使用 pandasnumpy 或其他库等第三方包。 本指南向您展示如何在 requirements.txt 文件中声明这些依赖项,以确保您的算法在各种环境中正常运行。

文件设置和规则

requirements.txt 是一个纯文本文件,用于指定项目所需的外部 Python 包。 您的 requirements.txt 文件应遵循以下规则:

  • 文件必须精确命名为 requirements.txt
  • 文件必须放置在项目根目录,与 Python 入口文件(例如 Super cBot_main.py)放在一起。
  • 文件应包含在项目文件中,以便与算法一起打包。

一旦 requirements.txt 文件存在并格式正确,只需构建您的项目,所有列出的依赖项将自动添加和解析。 以下是一个示例:

...\Documents\cAlgo\Sources\Robots\Super cBot\Super cBot

Image title

1
2
pandas==2.2.2
numpy>=1.26.4

支持的功能

requirements.txt 格式遵循 pip 使用的标准约定。 以下示例演示如何使用版本说明符指定包版本、添加注释并使用空行提高可读性:

固定到精确版本

1
pandas==2.2.2

允许最低版本

1
numpy>=1.26.4

使用注释和空行

1
2
3
4
5
# Data science libraries
pandas==2.2.2
numpy>=1.26.4

# You can leave blank lines for readability

最佳实践

  1. 固定关键库的版本,以避免新版本引入破坏性更改时出现意外行为。
  2. 如果对不太关键的包使用范围说明符,请在依赖项更新时测试您的算法。
  3. 考虑编写有意义的注释,解释为什么使用某些包或选择特定版本。
  4. 每次编辑 requirements.txt 时重新构建项目,以确保正确安装依赖项。

Image title