本文是「量投研习社」Day 2的首篇实战指南，专为量化新手设计。我们将手把手带你完成天勤SDK的完整安装配置，为后续的策略开发打下坚实基础。
引言：为什么选择天勤SDK？
在期货量化领域，选择一套可靠、易用的开发工具至关重要。天勤SDK（TqSdk）作为国内领先的量化开发包，具有以下核心优势：
无论你是刚接触Python的编程新手，还是已有交易经验但首次尝试量化的交易员，通过本文的指导，你都能在30分钟内完成环境搭建并运行第一个天勤SDK程序。
一、环境检查：准备工作清单
在开始安装之前，请确保你的系统满足以下基本要求：
表格
| | | |
|---|
| Windows 7 / macOS 10.12+ / Ubuntu 16.04+ | Windows 10 / macOS 12+ / Ubuntu 20.04+ | 系统属性 |
| | | python --version |
| | | |
| | | |
| | | |
重要提示：天勤SDK基于Python的异步协程（asyncio）开发，部分IDE（如Spyder、旧版Jupyter）可能不支持，推荐使用：
二、天勤SDK安装：三种方法详解
方法一：标准pip安装（推荐）
这是最简单快捷的安装方式，使用以下命令：
pip install tqsdk -U
参数说明：
方法二：使用国内镜像源加速
对于国内用户，建议使用清华大学镜像源，安装速度更快：
pip install tqsdk -U-i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
方法三：自动化安装脚本（最省心）
我们已为你准备了完整的自动化安装脚本，保存在 src/tq_sdk_install.py：
# 运行自动化安装脚本python src/tq_sdk_install.py
该脚本功能包括：
✅ Python版本检查
✅ pip工具验证
✅ 天勤SDK自动安装
✅ 安装结果验证
✅ 环境信息汇总
✅ 示例代码创建
核心代码片段（来自安装脚本）：
definstall_tqsdk():"""使用国内源安装天勤SDK""" install_cmd =[ sys.executable,"-m","pip","install","tqsdk","-U","-i","https://pypi.tuna.tsinghua.edu.cn/simple","--trusted-host","pypi.tuna.tsinghua.edu.cn"] process = subprocess.run(install_cmd, capture_output=True, text=True, check=True)if process.returncode ==0:print("✅ 天勤SDK安装成功")returnTrueelse:print(f"❌ 安装失败: {process.stderr}")returnFalse
三、验证安装：三步确认法
安装完成后，请按以下步骤验证：
步骤1：检查版本号
import tqsdkprint(f"天勤SDK版本: {tqsdk.__version__}")# 输出示例：3.8.9（2026年1月最新）
步骤2：导入核心模块
from tqsdk import TqApi, TqAuth, TqAccount, TqBacktestprint("✅ 核心模块导入成功")
步骤3：简单连接测试
# 注意：首次使用需要注册快期账户# api = TqApi(auth=TqAuth("您的快期账户", "您的密码"))# print("✅ 连接测试通过")
四、常见问题与解决方案
表格
| | |
|---|
ModuleNotFoundError: No module named 'tqsdk' | | |
ImportError: cannot import name 'TqApi' | | 升级到最新版本：pip install tqsdk -U |
| | |
SSL Certificate | | |
| | |
特殊提示：如果使用Anaconda环境，建议在base环境或创建独立环境安装，避免与其他包冲突。
五、第一个示例：获取实时行情
完成安装验证后，让我们运行一个简单的实时行情获取程序：
#!/usr/bin/env python# -*- coding: utf-8 -*-"""天勤SDK实时行情示例功能：获取螺纹钢主力合约的实时行情"""import asynciofrom tqsdk import TqApi, TqAuthasyncdefmain():"""主函数"""# 创建API连接（需要替换为你的快期账户） api = TqApi(auth=TqAuth("您的快期账户","您的密码"))# 获取合约行情 quote = api.get_quote("SHFE.rb2510")# 等待第一次数据更新await api.wait_update()# 打印行情信息print(f"合约名称: {quote.instrument_name}")print(f"最新价格: {quote.last_price}")print(f"涨跌: {quote.last_price - quote.pre_close:+.2f}")print(f"成交量: {quote.volume:,}手")print(f"持仓量: {quote.open_interest:,}手")# 持续更新（按Ctrl+C停止）whileTrue:await api.wait_update()print(f"\r最新价: {quote.last_price:.2f}", end="", flush=True)if __name__ =="__main__": asyncio.run(main())
运行效果：
合约名称: 螺纹钢2510最新价格: 3850.50涨跌: +25.50成交量: 125,430手持仓量: 890,120手最新价: 3851.00（实时更新）
六、下一步行动：注册快期账户
要使用天勤SDK的全部功能，你需要注册一个快期账户：
- 访问官网：https://www.shinnytech.com/tianqin/
- 手机注册
- 账户类型
- 获取凭证
合规提醒：所有实盘交易必须遵守穿透式监管要求，天勤SDK已内置相关合规模块。
七、总结与思考题
通过本文，你已经完成了：
✅ 理解了天勤SDK的核心价值
✅ 掌握了三种安装方法
✅ 学会了安装验证技巧
✅ 了解了常见问题解决方案
✅ 运行了第一个实时行情示例
思考题：
- 如果你的Python环境中有多个版本，如何确保天勤SDK安装到正确的版本？
- 在无法连接外网的环境下，如何离线安装天勤SDK及其依赖包？
- 天勤SDK的异步协程架构相比传统同步接口有哪些优势？
实践任务：
技术要点回顾
- 技术栈统一
- 异步架构
- 国内优化
- 完整生态
- 合规内置
下一篇预告：明天我们将深入讲解《天勤SDK行情API实战：实时获取期货行情与深度数据》，教你构建专业的行情监控系统。记得关注「量投研习社」，不错过每篇干货！
本文为Day 2新手入门系列第一篇，后续将逐步深入策略开发。市场有风险，量化需谨慎。安装过程中如遇问题，欢迎在评论区留言讨论。
