当前位置：首页 > news >正文

Python期货量化项目结构_代码组织最佳实践

news 2026/5/12 2:44:10

免责声明：本文基于个人使用体验，与任何厂商无商业关系。内容仅供技术交流参考，不构成投资建议。

一、前言

量化项目随着策略增多会变得复杂，合理的项目结构能提高开发效率和代码可维护性。做了二十年期货交易，我经历过项目从混乱到有序的演进。

二、推荐项目结构

quant_project/ ├── config/ # 配置 │ ├── __init__.py │ └── settings.py ├── strategies/ # 策略 │ ├── __init__.py │ ├── base.py # 基类 │ ├── ma_strategy.py │ └── breakout_strategy.py ├── utils/ # 工具 │ ├── __init__.py │ ├── indicators.py │ └── risk.py ├── data/ # 数据（如本地缓存） ├── logs/ # 日志 ├── main.py # 入口 ├── backtest.py # 回测入口 └── requirements.txt

三、策略基类设计

# strategies/base.pyfromabcimportABC,abstractmethodfromtqsdkimportTqApiclassBaseStrategy(ABC):"""策略基类"""def__init__(self,api:TqApi,symbol:str,**params):self.api=api self.symbol=symbol self.params=params self.klines=api.get_kline_serial(symbol,params.get('interval',300),params.get('klines_len',500))self.position=api.get_position(symbol)@abstractmethoddefon_bar(self,klines):"""K线更新回调"""passdefrun(self):"""策略主循环"""whileTrue:self.api.wait_update()ifself.api.is_changing(self.klines):self.on_bar(self.klines)

四、具体策略实现

# strategies/ma_strategy.pyfrom.baseimportBaseStrategyfromtqsdk.taimportMAclassMAStrategy(BaseStrategy):"""均线策略"""defon_bar(self,klines):ma5=MA(klines,5)ma20=MA(klines,20)iflen(ma5.ma)<2orlen(ma20.ma)<2:return# 金叉ifma5.ma.iloc[-2]<ma20.ma.iloc[-2]andma5.ma.iloc[-1]>=ma20.ma.iloc[-1]:ifself.position.pos_long==0:self.api.insert_order(self.symbol,"BUY","OPEN",1)# 死叉elifma5.ma.iloc[-2]>ma20.ma.iloc[-2]andma5.ma.iloc[-1]<=ma20.ma.iloc[-1]:ifself.position.pos_long>0:self.api.insert_order(self.symbol,"SELL","CLOSE",self.position.pos_long)

五、入口与配置

# main.pyfromtqsdkimportTqApi,TqAuth,TqAccount,TqBacktestfromdatetimeimportdatefromconfig.settingsimportConfigfromstrategies.ma_strategyimportMAStrategydefmain():# 回测api=TqApi(backtest=TqBacktest(start_dt=date(2024,1,1),end_dt=date(2025,12,31)),auth=TqAuth(Config.TQ_USER,Config.TQ_PASS))strategy=MAStrategy(api,"SHFE.rb2510")strategy.run()if__name__=="__main__":main()