INSTALL.md

Tushare缓存系统 (Tushare Cache System) - 安装指南

安装方式

1. 使用pip安装（推荐）

pip install tushare-cache-system

2. 从源码安装

git clone https://github.com/yourusername/tushare-cache-system.git
cd tushare-cache-system
pip install -e .

3. 开发环境安装

git clone https://github.com/yourusername/tushare-cache-system.git
cd tushare-cache-system
pip install -e ".[dev]"

系统要求

• Python 3.6+
• 操作系统：Windows、macOS、Linux

依赖项

核心依赖

• pandas>=1.0.0
• numpy>=1.18.0
• tushare>=1.2.0
• python-dotenv>=0.19.0

可选依赖

• requests>=2.25.0
• sqlalchemy>=1.3.0
• openpyxl>=3.0.0

开发依赖

• pytest>=6.0
• pytest-cov
• black
• flake8
• mypy

验证安装

安装完成后，可以通过以下命令验证：

import tushare_cache_system as ts

# 初始化（需要有效的tushare token）
pro = ts.pro_api('your_token')

# 测试API调用
stock_basic = pro.stock_basic(exchange='', list_status='L')
print(stock_basic.head())

常见问题

1. 安装失败

如果安装失败，请尝试：

# 升级pip
pip install --upgrade pip

# 使用国内镜像
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple tushare-cache-system

2. 导入错误

如果出现导入错误，请检查：

1. Python版本是否符合要求
2. 所有依赖项是否正确安装
3. 是否有多个Python环境导致混乱

3. Token错误

如果出现token相关错误，请：

1. 确保已注册tushare账号并获取有效token
2. 检查token是否正确传递给pro_api()函数
3. 确认token权限是否足够访问所需数据

卸载

pip uninstall tushare-cache-system