Windows系统如何安装Waeup并正常运行？依赖安装失败解决方案

• 预装基础运行环境
  确认系统为Windows 10 21H2及以上/Windows 11正式版，提前安装Visual C++ Redistributable 2015-2022（x64）、Python 3.9~3.11版本，安装Python时必须勾选Add Python to PATH选项，Waeup暂不兼容Python 3.12+版本。如果需要安装带C扩展的依赖，额外安装Visual Studio Build Tools，勾选「使用C++的桌面开发」工作负载，所有预装组件安装完成后重启电脑。
• 虚拟环境隔离安装（官方推荐，可规避90%以上依赖冲突问题）
  在纯英文、无空格、无特殊字符的非系统盘路径下新建安装目录，例如D:\waeup_workspace，在文件夹地址栏输入cmd调出命令提示符，依次执行以下命令：

  python -m venv venv
  venv\Scripts\activate
  pip install --upgrade pip setuptools wheel
  pip install waeup
  

• 安装有效性验证
  保持虚拟环境激活状态，执行waeup --version，终端正常输出版本号即代表核心组件安装完成，后续执行waeup init完成初始化配置后即可正常启动运行。

• 路径相关报错
  若报错提示文件不存在、路径无法识别，优先检查Python安装路径、虚拟环境路径是否包含中文、空格、特殊emoji或全角字符，将相关目录迁移到纯英文无空格路径下重新执行安装即可，禁止将安装目录放在「下载」「桌面」等默认带中文用户路径的位置。
• C编译类依赖报错
  若报错提示Microsoft Visual C++ 14.0 or greater is required，说明缺少C编译环境，重新运行Visual Studio Build Tools安装程序补装C桌面开发组件，重启终端后重试即可；如果不想安装完整编译工具，可直接下载对应Python版本、系统架构的依赖whl离线包，执行pip install 下载的whl文件完整路径完成手动安装。
• 网络类下载失败
  若报错提示连接超时、下载中断、SSL证书错误，是默认PyPI源访问不稳定导致，安装时追加国内镜像源参数即可，示例命令：

  pip install waeup --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  若使用公司、校园网等受限网络出现下载拦截，直接切换到个人手机热点重试即可。
• 版本冲突类报错
  若报错提示依赖版本不兼容、已安装包版本不符合要求，说明当前环境存在包版本冲突，直接删除虚拟环境目录下的venv文件夹，重新创建干净的虚拟环境从头执行安装步骤即可，禁止直接在全局Python环境中安装Waeup，极易和其他Python软件的依赖产生冲突。
• 权限类报错
  若报错提示权限不足、拒绝访问，不要直接用管理员权限运行终端安装，这类问题一般是Python被安装在C盘系统保护目录导致，要么给当前Python安装目录授予登录用户的完全控制权限，要么将Python改装到非系统盘的纯英文路径下即可解决。

注意：不要在WSL1环境下安装运行Windows版本Waeup，WSL1和Windows文件系统的互操作层存在已知兼容问题，会导致部分依赖加载失败，原生Windows cmd、PowerShell下的虚拟环境是兼容性最高的运行环境。

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