[Q&A] pip install 失败？环境配置常见问题汇总

[csmar432]

提问模板

报错信息：
  ModuleNotFoundError: No module named '...'

环境：macOS 14.5, Python 3.12.3

执行命令：
  pip install -e ".[dev]"

期望：完成安装
实际：报错

常见解决方案

1. Python 版本问题：确认 Python ≥ 3.10

   python3 --version

2. 依赖冲突：尝试虚拟环境

   python3 -m venv .venv
   source .venv/bin/activate
   pip install -e ".[dev]"

3. MCP Token 缺失：

   cp .env.example .env.local
   # 编辑 .env.local 添加 TUSHARE_TOKEN 等

4. 网络问题：检查代理设置或使用镜像

   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -e ".[dev]"

其他问题请在下方评论！