前置条件
安装前确认环境满足以下要求。
| 项 | 要求 | 说明 |
|---|---|---|
| Python | 3.x | 官方 badge 标注 python-3.6 起步；建议用较新版本配合 Stable Baselines3 |
| Git | 已安装 | 用于 clone 仓库 |
| 依赖 | PyTorch / Stable Baselines3 / gym 等 | pip install -e . 自动按 requirements.txt 安装 |
| 磁盘/网络 | 足够空间 + 可访问 GitHub/PyPI | 需下载依赖与行情数据 |
三步安装
官方 2026 教程的标准流程，逐步执行即可。
克隆仓库
git clone https://github.com/AI4Finance-Foundation/FinRL.git，然后cd FinRL。创建并激活虚拟环境
python3 -m venv venv，然后source venv/bin/activate（Windows 用venv\Scripts\activate）。安装 FinRL
pip install -e .以可编辑模式安装，自动拉取依赖。
验证安装
安装后验证是否能正常 import。
python -c "import finrl; print('finrl ok')"若无报错即安装成功；若报依赖缺失，按提示 pip install 对应包后重试。
Windows 安装注意
经典 FinRL 教程示例以 Linux/macOS 的 source venv/bin/activate 为主。
激活命令不同
Windows 用
venv\Scripts\activate而非source。编译依赖
部分依赖可能涉及 C/C++ 编译，若 pip 编译失败，优先用预编译 wheel 或 conda 环境。
官方文档
README 提供「Install description for all operating systems (MAC OS, Ubuntu, Windows 10)」链接，遇到问题以官方文档为准。
不想装环境的替代路线
FinRL 需要自建 Python 环境与依赖；如果只想快速拿到行情、选股、量化分析结论，可看 EasyClaw 量化 Skill 免部署路线（不代表 FinRL 已集成 EasyClaw）。
常见问题
FinRL 能用 pip install finrl 一条命令装吗？
经典版官方 2026 教程推荐 clone 仓库后 pip install -e .，而非从 PyPI 直接 pip install finrl（旧版本名可能已过时）。以官方 README 为准。
FinRL 装完要多少空间？
主要开销是 Python 依赖（PyTorch 较大）与后续下载的行情数据。具体以实际安装与数据下载为准。
Windows 能装 FinRL 吗？
能，但激活虚拟环境命令与编译依赖需注意，官方文档有针对 Windows 10 的安装说明。
装完直接能交易吗？
不能。经典版是研究框架，需自行训练、回测；实盘接入基础支持 Alpaca，生产级多账户走 FinRL-X/FinRL-Trading。任何策略都不得未经回测直接实盘。