前言
国内期货策略从历史回测到快期模拟再到实盘，若用三个 Python 文件维护，极易出现“回测删了的过滤、实盘忘记加”。工程上更常见的是：一个 strategy.py + 配置文件/环境变量指定 MODE，仅make_api()里TqApi构造不同。
天勤支持TqBacktest、TqSim、TqKq、TqAccount同一套get_kline_serial与datetime触发逻辑。本文给.env+make_api示例，并说明期货部署时为何要重启进程切换环境、密码如何不入库。
一、为什么用环境变量
- 回测区间
TQ_BT_START/TQ_BT_END常改； - 模拟与实盘密码不能写进 git；
- 运维在服务器注入
TQ_MODE=live，策略代码无硬编码。
二、.env 示例（读者按户名修改）
TQ_USER=快期账户 TQ_PASS=密码 TQ_MODE=backtest TQ_BT_START=2024-01-01 TQ_BT_END=2024-06-30 BROKER=南华期货 ACCOUNT=123456 ACCOUNT_PASS=****TQ_MODE取值：backtest|sim|kq|live。
三、make_api 与 main
importosfromdatetimeimportdatefromtqsdkimportTqApi,TqAuth,TqSim,TqKq,TqAccount,TqBacktest,BacktestFinisheddefmake_api():auth=TqAuth(os.environ["TQ_USER"],os.environ["TQ_PASS"])mode=os.environ["TQ_MODE"]ifmode=="backtest":returnTqApi(backtest=TqBacktest(start_dt=date.fromisoformat(os.environ["TQ_BT_START"]),end_dt=date.fromisoformat(os.environ["TQ_BT_END"]),),auth=auth,)ifmode=="kq":returnTqApi(TqKq(),auth=auth)ifmode=="live":returnTqApi(TqAccount(os.environ["BROKER"],os.environ["ACCOUNT"],os.environ["ACCOUNT_PASS"]),auth=auth,)returnTqApi(TqSim(),auth=auth)defmain():api=make_api()print("当前 MODE",os.environ["TQ_MODE"])try:run(api)# 内含 wait_update、is_changing(datetime)、TargetPosTaskexceptBacktestFinished:export_result(api)finally:api.close()run(api)内不出现if live，期货合约列表来自config.SYMBOLS。
四、config 与策略分离
config.py：SYMBOLS = ["SHFE.rb2510"]、DURATION = 300、LOTS = 1。
回测与实盘共用，换月只改 config。
五、部署注意（期货 7×24）
| 环境 | MODE | 说明 |
|---|---|---|
| CI 回测 | backtest | 单次进程 |
| 服务器模拟 | kq | 单实例守护 |
| 实盘 | live | 启动前人工确认 MODE |
切换 MODE 必须重启进程，不可热替换 Api；夜盘策略注意机器勿休眠。
六、验证
改 MODE 后跑 30 分钟：K 线datetime推进、模拟下一笔小单、position 与日志一致。live 前加二次确认变量。
总结
回测、模拟、实盘三环境用配置文件切换make_api()，期货策略主体共用datetime触发与 TargetPosTask。天勤构造四种模式覆盖国内期货全流程；密码用环境变量，代码不入库。
这是团队减少“环境抄错一行”的实用做法，比复制三份策略文件可靠。
FAQ
1）yaml 可以吗？
可以，解析后传入 make_api。
2）多策略？
每策略独立 env 前缀或独立服务。
3）docker？
启动时注入 env，镜像内不写密码。
4）误连实盘？
启动打印 MODE，live 需显式确认。
风险提示
本文讨论部署，不构成投资建议。
