mootdx环境配置指南：从环境检测到功能验证的完整流程

环境兼容性检测 📋

在开始安装mootdx前，需确保系统环境满足运行要求。执行以下命令检查关键依赖项：

# 检查Python版本（需3.8+）
python --version

# 检查pip版本
pip --version

# 检查系统架构（64位系统要求）
uname -m  # Linux/macOS
# 或
systeminfo | findstr "系统类型"  # Windows

兼容标准：

• 操作系统：Windows 10/11、macOS 10.15+、Linux kernel 4.15+
• Python环境：3.8-3.11版本（建议3.9+）
• 网络环境：可访问PyPI仓库（用于依赖安装）

安装方案选择 ⚙️

基础版安装（核心功能）

适合仅需基础数据读取功能的用户：

# 安装核心组件
pip install mootdx

专业版安装（全功能套件）

推荐给需要完整功能的专业用户：

# 包含数据解析、网络请求、命令行工具的完整安装
pip install 'mootdx[all]'

定制版安装（按需选择）

根据实际需求组合安装选项：

# 基础功能 + 命令行工具
pip install 'mootdx[cli]'

# 基础功能 + 财务数据模块
pip install 'mootdx[financial]'

# 完整功能 + 开发依赖（适合贡献者）
pip install 'mootdx[dev]'

安装验证流程 ✅

版本验证

# 命令行版本检查
python -m mootdx --version

# Python交互环境验证
python -c "import mootdx; print(f'mootdx v{mootdx.__version__} 安装成功')"

功能验证

创建测试脚本verify_mootdx.py：

from mootdx.reader import Reader

# 初始化标准市场读取器
reader = Reader.factory(market='std', tdxdir='C:/tdx')  # Windows示例路径
# reader = Reader.factory(market='std', tdxdir='/Applications/TDX')  # macOS示例路径

# 读取日线数据（600036为招商银行代码）
data = reader.daily(symbol='600036')
print(f"成功读取 {len(data)} 条日线数据")
print(data.head())  # 打印前5条记录

执行脚本验证数据读取功能：

python verify_mootdx.py

故障诊断矩阵 🔍

问题现象	可能原因	解决方案
安装时报错"permission denied"	权限不足	使用虚拟环境或添加--user参数：pip install --user mootdx
导入时提示"ModuleNotFoundError"	依赖缺失	重新安装并指定依赖组：pip install 'mootdx[all]'
数据读取返回空值	通达信路径错误	确认tdxdir指向正确的通达信安装目录
网络请求超时	服务器连接问题	执行最佳IP检测：python -m mootdx bestip
M1/M2 Mac运行异常	架构兼容性	安装Rosetta 2：softwareupdate --install-rosetta

功能拓展与应用 🚀

基础数据操作

# 获取实时行情
from mootdx.quotes import Quotes
client = Quotes.factory(market='std')
quote = client.quote(symbol='600036')
print(quote)

高级数据处理

# 财务数据解析示例
from mootdx.affair import Affair
data = Affair.parse(datestr='2023-03-31')
print(data[['code', 'name', 'eps']].head())  # 显示每股收益数据

命令行工具应用

# 导出日线数据到CSV
mootdx export --symbol 600036 --start 20230101 --end 20231231 --output data.csv

# 检测最佳服务器连接
mootdx bestip --show all

维护与更新 🔄

定期更新以获取最新功能和修复：

# 升级到最新版本
pip install -U mootdx[all]

# 查看更新日志
pip show -f mootdx | grep CHANGES

完整使用文档请参阅项目内的官方文档：docs/index.md。如遇功能问题，可查阅测试用例获取参考实现：tests/。