PTrade 量化交易：initialize 初始化函数完整详解

考虑到很多小伙伴开始尝试用 PTrade 进行量化策略调整与编写，但打开 API 文档又觉得 “看不懂、不会用”。

别担心！我会每次拆解 1-2 个核心函数，用大白话讲清楚 “它是啥、怎么用、注意啥”，还附案例。

今天我们就从最基础的initialize函数说起 —— 它就像咱们用家电前的 “插电开机” 步骤，是策略运行的第一步，得搞明白。

一、initialize 函数是啥

initialize函数的中文意思是 “初始化”，简单说就是策略启动时（不管是回测还是实盘交易），只运行一次的 “准备工作”。比如咱们要做一道菜，得先准备好食材、调料；

initialize函数就是帮咱们在策略开始前，把 “要用的股票、要设的参数、要记的变量” 都准备好，避免后续步骤手忙脚乱。

举个生活例子：你用手机导航去某个地方，打开导航 APP 的瞬间（对应策略启动），APP 会先加载你的当前位置、设置好导航模式（驾车 / 步行）—— 这个 “加载 + 设置” 的过程，就相当于initialize函数的作用。

二、函数怎么写？

initialize函数的写法特别固定，核心结构只有 2 部分：函数名 + 参数，咱们先看最基础的模板：

咱们逐句解释下，不用记术语，跟着理解就行：

l def initialize(context):：这是函数的 “固定开头”，就像写信要写 “尊敬的 XX” 一样，少一个字都不行。其中context是个 “信息包”，里面装着账户资金、持仓等关键信息，后续会用到。

l 第二行开头的#：代表 “注释”，就是咱们写给自己看的说明，电脑不会执行这行内容，建议每次都写清楚，方便以后回忆。

l pass：如果暂时没想好要准备啥，就写pass，避免电脑报错。

一、模拟场景：3 个常用的准备工作

咱们通过 3 个更贴近操作习惯的模拟场景，让代码更简单。

场景 1：设定 “每次最多花多少钱买股票”（控制风险）

很多朋友炒股时会给自己定规矩：“每次买股票最多花 5 万块”，这个规矩可以在initialize里提前设好，避免一时冲动买太多。

怎么改？想每次最多花 3 万，就改成g.max_money = 30000，简单直观。

场景 2：选定 “自己熟悉的 1-2 只股票”（只做熟股）

老股民常说 “不熟不做”，initialize可以帮咱们把熟悉的股票 “圈起来”，确保策略只在这些股票里操作，避免买到不了解的标的。

代码例子（比如只做贵州茅台和招商银行）：

怎么查代码？打开炒股软件，搜股票名称就能看到代码，比如茅台是 600519，就在后面加.SS。

场景3：设置 “单只股票最多买多少股”（分散风险）

有的朋友习惯 “鸡蛋不放在一个篮子里”，比如 “单只股票最多买 1000 股”，这个规则也能在initialize里提前设定。

为什么要设？避免某只股票突然大跌时亏太多，符合中老年朋友 “稳当炒股” 的习惯。

一、必须注意的 3 个 “坑”

1）只运行一次，别写重复操作：

initialize函数只有策略启动时会运行一次，比如你想 “每天看账户余额”，就不能写在这里（后续会讲专门的函数做这事），不然只会看一次，后面就看不到了。

2）数字不用加单位，直接写阿拉伯数字

写金额时直接写50000（代表 5 万元），不用写50000元；写股数时直接写1000（代表 1000 股），不用加 “股” 字 —— 电脑只认纯数字。

3）股票代码必须加后缀，否则会报错

上海的股票（6 开头）加.SS，比如600519.SS（茅台）；深圳的（0 或 3 开头）加.XSHE，比如000858.XSHE（五粮液）。忘了加后缀，策略会找不到这只股票。

二、简单案例

咱们整合一个最简单的版本，只有 3 行核心代码，复制到 Ptrade 里就能用：

怎么用？把这段代码复制到 Ptrade 的策略编辑器，点 “运行” 或 “回测”，在日志里看到 “初始化完成！……” 这句话，就说明成功了。后续学了买卖函数，直接加进去就能用。

感兴趣的小伙伴快去试试吧！