⚠️ Alpha内测版本警告:此为早期内部构建版本,尚不完整且可能存在错误,欢迎大家提Issue反馈问题或建议。
Skip to content

环境配置指南 — 快速开始

版本: v2.2
最后更新: 2026-06-03

本文档覆盖核心路径(5分钟快速开始)。

其他场景?选择下方导航:


系统要求

操作系统 — Linux / macOS / Windows (WSL2)
Python — 3.10+ (推荐 3.11)
磁盘 — 500 MB(最小)

检查 Python:

bash
python3 --version

5 分钟快速开始

步骤 1:选择环境

A. conda(推荐)

bash
conda create -n sti python=3.11 --no-default-packages -y
conda activate sti
pip install --upgrade pip setuptools wheel

B. venv(标准 Python)

bash
git clone <repo-url>
cd signal-to-intelligence
python3 -m venv venv
source venv/bin/activate      # Linux/macOS
# venv\Scripts\Activate.ps1   # Windows
pip install --upgrade pip setuptools wheel

步骤 2:安装依赖

bash
pip install -e .

完成 — 可以运行第 1-6 章全部 + 第 7-8 章部分实验

步骤 3:验证

bash
python3 code/ch01_dsp/fft_spectrum.py
pytest tests/ -v

接下来


常见问题

如何退出虚拟环境?

bash
deactivate

Windows 权限错误?

以管理员身份运行 PowerShell。

重新安装依赖?

bash
pip install --force-reinstall -e .

有 GPU / 要用 API / 要云端?

见上方导航链接。


获取帮助

本教程采用 CC BY-NC-SA 4.0 许可协议