使用Tinkoff API 2.0遇问题：虚拟环境无法识别已安装的tinkoff-investments

可能的原因及对应解决方案 #

1. 确认虚拟环境已正确激活 #

• 运行代码前，必须激活目标虚拟环境：
  • Windows系统：执行 venv\Scripts\activate
  • macOS/Linux系统：执行 source venv/bin/activate
• 激活成功后，终端提示符会显示(venv)标识，此时再执行模块安装和代码运行操作。

2. 检查模块是否安装在当前虚拟环境内 #

• 激活虚拟环境后，执行 pip list，查看输出列表中是否存在tinkoff-investments。
• 若未找到，在激活的虚拟环境中重新执行 pip install tinkoff-investments，确保安装路径指向虚拟环境的site-packages目录。

3. 排查项目目录的命名冲突 #

• 检查项目根目录下是否存在tinkoff.py文件或tinkoff文件夹，这类本地文件/目录会和第三方模块命名冲突，导致Python优先加载本地内容而非已安装的模块。
• 如有冲突，立即重命名或删除这些文件/目录。

4. 验证Python解释器路径 #

• 在激活的虚拟环境中，执行 which python（macOS/Linux）或 where python（Windows），确认当前使用的是虚拟环境内的Python解释器。
• 若使用IDE运行代码，需在IDE设置中指定虚拟环境的Python解释器为当前运行环境。

测试验证步骤 #

激活虚拟环境后，先在Python交互环境中做基础验证：

import sys
print(sys.path)  # 查看Python模块搜索路径，确认虚拟环境的site-packages目录在列表中
from tinkoff.invest import Client
print("模块导入成功")

若导入无报错，再运行你的业务代码即可。

内容的提问来源于stack exchange，提问作者Ivan