当前位置：首页 > news >正文

Qwen3-ASR-1.7B在Win11系统上的开发环境搭建

news 2026/4/16 5:53:47

Qwen3-ASR-1.7B在Win11系统上的开发环境搭建

1. 引言

想在Windows 11上体验强大的语音识别能力吗？Qwen3-ASR-1.7B作为一款支持52种语言和方言的语音识别模型，确实让人心动。但在Windows环境下直接部署可能会遇到各种环境配置问题，特别是CUDA和依赖库的兼容性。

别担心，今天我就带你一步步在Win11系统上搭建Qwen3-ASR-1.7B的开发环境。我会分享实际踩过的坑和解决方案，让你少走弯路，快速上手这个强大的语音识别模型。

2. 环境准备

2.1 系统要求

在开始之前，先确认你的系统满足以下要求：

Windows 11 64位系统（版本22H2或更高）
NVIDIA显卡（GTX 1060或更高，建议RTX 2060以上）
至少8GB系统内存（推荐16GB或以上）
至少20GB可用磁盘空间
CUDA兼容的NVIDIA驱动程序

2.2 启用WSL2

由于Qwen3-ASR的某些依赖在Windows原生环境下兼容性不佳，我们使用WSL2（Windows Subsystem for Linux）来创建Linux环境：

以管理员身份打开PowerShell
运行以下命令：

wsl --install

重启电脑完成安装
安装完成后，设置WSL2为默认版本：

wsl --set-default-version 2

2.3 安装Ubuntu发行版

打开Microsoft Store，搜索"Ubuntu"并安装最新的LTS版本。安装完成后，启动Ubuntu并设置用户名和密码。

3. CUDA环境配置

3.1 安装NVIDIA驱动

首先在Windows环境下安装最新的NVIDIA显卡驱动：

访问NVIDIA官网下载页面
选择你的显卡型号和Windows 11系统
下载并安装最新的Game Ready或Studio驱动

3.2 在WSL2中安装CUDA

在Ubuntu终端中执行以下命令：

# 添加NVIDIA包仓库 wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2004/x86_64/cuda-keyring_1.0-1_all.deb sudo dpkg -i cuda-keyring_1.0-1_all.deb sudo apt-get update # 安装CUDA工具包 sudo apt-get install cuda-toolkit-12-2 # 设置环境变量 echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc echo 'export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc source ~/.bashrc

3.3 验证CUDA安装

检查CUDA是否安装成功：

nvidia-smi nvcc --version

如果看到GPU信息和CU版本信息，说明安装成功。

4. Python环境配置

4.1 安装Python和必要工具

# 更新包列表 sudo apt update # 安装Python和pip sudo apt install python3 python3-pip python3-venv # 安装开发工具 sudo apt install build-essential libssl-dev libffi-dev python3-dev

4.2 创建虚拟环境

建议为Qwen3-ASR创建独立的虚拟环境：

# 创建项目目录 mkdir qwen3-asr-project cd qwen3-asr-project # 创建虚拟环境 python3 -m venv venv # 激活虚拟环境 source venv/bin/activate

5. 安装Qwen3-ASR依赖

5.1 安装PyTorch

根据你的CUDA版本安装对应的PyTorch：

# 对于CUDA 12.x pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 # 安装其他依赖 pip install numpy soundfile librosa

5.2 安装ModelScope

pip install modelscope

5.3 安装vLLM后端

vLLM是高效推理的关键组件：

pip install -U qwen-asr[vllm]

6. 模型下载与配置

6.1 设置模型缓存路径

为了避免重复下载，设置模型缓存路径：

# 设置环境变量 echo 'export MODELSCOPE_CACHE=/mnt/d/AI' >> ~/.bashrc source ~/.bashrc # 创建缓存目录 mkdir -p /mnt/d/AI

6.2 下载模型

使用ModelScope下载Qwen3-ASR-1.7B模型：

modelscope download --model Qwen/Qwen3-ASR-1.7B

下载过程可能需要一些时间，取决于你的网络速度。

7. 常见问题解决

7.1 CUDA版本兼容性问题

如果你遇到CUDA兼容性错误，可能是PyTorch版本与CUDA版本不匹配。可以通过以下命令检查：

import torch print(torch.__version__) print(torch.cuda.is_available()) print(torch.cuda.get_device_capability())

7.2 内存不足问题

Qwen3-ASR-1.7B需要较多的GPU内存。如果遇到内存不足，可以尝试：

使用更小的批次大小
启用梯度检查点
使用混合精度训练

7.3 音频处理问题

确保安装了正确的音频处理库：

pip install soundfile librosa audioread

8. 测试环境是否正常工作

创建一个简单的测试脚本验证环境：

import torch from qwen_asr import Qwen3ASRModel import os # 检查CUDA是否可用 print(f"CUDA available: {torch.cuda.is_available()}") print(f"GPU device: {torch.cuda.get_device_name(0)}") # 设置模型路径 model_path = os.path.join( os.environ.get("MODELSCOPE_CACHE", ""), "models", "Qwen", "Qwen3-ASR-1.7B" ) print(f"Model path: {model_path}")

运行这个脚本，如果没有报错且能正确识别GPU设备，说明环境配置成功。