一、Python 多版本管理（使用官方 PyManager）

1. 安装 PyManager

# 方法1：winget 安装
winget install Python.PythonInstallManager

# 方法2：Microsoft Store 搜索 "Python Manager" 安装

2. 常用 py 命令

# 查看已安装版本
py list

# 查看可安装版本
py list --online

# 安装指定版本（如3.12）
py install 3.12

# 使用特定版本运行
py -3.12 script.py
py -3.12 -m venv .venv    # 创建虚拟环境

# 设置默认版本
$Env:PYTHON_MANAGER_DEFAULT="3.12"

二、CoPaw 安装过程

1. 创建虚拟环境并安装（推荐）

# 进入项目目录
cd H:\copaw

# 创建虚拟环境（使用Python 3.12）
py -3.12 -m venv .venv

# 激活虚拟环境
.venv\Scripts\Activate.ps1

# 安装 CoPaw
pip install copaw

2. 如果遇到版本兼容性问题

# Python 3.14 太新时，降级到3.12
py install 3.12
py -3.12 -m venv .venv
.venv\Scripts\Activate.ps1
pip install copaw

三、CoPaw 日常使用

1. 启动服务

# 方法1：进入目录后直接启动
cd H:\copaw
copaw app

# 方法2：如果提示找不到命令，用模块模式
python -m copaw app

# 方法3：使用虚拟环境（如果之前用了）
cd H:\copaw
.venv\Scripts\Activate.ps1
copaw app

2. 重启服务（关机后）

# 打开 PowerShell，执行：
cd H:\copaw
.venv\Scripts\Activate.ps1    # 如果用了虚拟环境
python -m copaw app            # 或 copaw app

3. 停止服务

- 在运行窗口按 Ctrl + C

四、常用查看命令

# 查看已安装包
pip list
pip list | findstr copaw      # 只查看 copaw
pip show copaw                 # 查看详细信息

# 查看 Python 版本
python --version
py list                        # 查看所有已安装版本

# 导出/导入环境
pip freeze > requirements.txt  # 导出
pip install -r requirements.txt # 导入

五、常见问题解决

1. copaw: command not found

# 原因：环境变量问题
# 解决：使用模块模式运行
python -m copaw app

# 或重新激活虚拟环境
.venv\Scripts\Activate.ps1

2. 版本不兼容错误

# 错误示例：Requires-Python >=3.10,<3.14
# 解决：安装Python 3.12
py install 3.12
py -3.12 -m venv .venv

3. pip 升级提示

# 看到 [notice] A new release of pip is available
python -m pip install --upgrade pip

六、重要路径记录

- 项目目录: H:\copaw

- 虚拟环境: H:\copaw\.venv

- Python 3.12 安装: 由 py 管理器自动管理

- CoPaw 访问地址: 启动后通常显示在控制台 (如 http://127.0.0.1:8088)

七、下次启动速查表

# 一行命令快速启动
cd H:\copaw; .venv\Scripts\Activate.ps1; python -m copaw app

# 或者保存为脚本文件 start_copaw.ps1

记住：如果直接输入 copaw app 找不到命令，就用 python -m copaw app，这是最稳妥的方法！