☰
WSL2安装Ubuntu与Ollama机器学习环境配置指南
2026/10/28 18:16:40 网站建设 项目流程

1. WSL2环境准备与Ubuntu安装

在Windows系统上使用WSL2运行Ubuntu已经成为开发者搭建Linux开发环境的首选方案。相比传统虚拟机,WSL2提供了近乎原生的性能体验,同时保持了与Windows系统的无缝集成。我最近在WSL2 Ubuntu 22.04 LTS上成功部署了Ollama(一个流行的机器学习工具),整个过程遇到不少值得分享的经验。

1.1 启用WSL2功能

首先需要确保你的Windows版本支持WSL2。Win10 2004及以上或Win11系统都可以完美运行。以管理员身份打开PowerShell,执行以下命令启用WSL功能:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启后,将WSL2设为默认版本:

wsl --set-default-version 2

注意:部分老款CPU可能需要先在BIOS中启用虚拟化技术(VT-x/AMD-V)。如果遇到"此计算机上未启用虚拟化"错误,需要进入主板设置开启相关选项。

1.2 安装Ubuntu发行版

微软商店提供了多个Ubuntu版本,推荐选择22.04 LTS以获得长期支持。安装完成后,首次启动会提示创建用户名和密码。这里有个实用技巧:密码可以简单设置(如123456),因为WSL环境下sudo不需要频繁输入密码。

配置APT国内镜像源能显著提升安装速度:

sudo sed -i "s@http://.*archive.ubuntu.com@https://mirrors.aliyun.com@g" /etc/apt/sources.list sudo sed -i "s@http://.*security.ubuntu.com@https://mirrors.aliyun.com@g" /etc/apt/sources.list sudo apt update && sudo apt upgrade -y

2. Ollama安装与配置

Ollama是一个轻量级的机器学习工具链管理工具,特别适合在WSL2这样的环境中使用。它能够简化各种AI框架和工具的安装过程。

2.1 基础依赖安装

在安装Ollama前,需要确保系统具备必要的开发环境:

sudo apt install -y build-essential cmake git wget curl libssl-dev zlib1g-dev

对于GPU加速支持(如果你的Windows已安装NVIDIA驱动):

sudo apt install -y nvidia-cuda-toolkit

实测发现:WSL2中的CUDA环境需要Windows端先安装对应版本的NVIDIA驱动。建议通过Windows端的GeForce Experience保持驱动更新。

2.2 Ollama安装步骤

官方提供了便捷的一键安装脚本:

curl -fsSL https://ollama.ai/install.sh | sh

安装完成后,将Ollama加入PATH:

echo 'export PATH=$PATH:~/.ollama/bin' >> ~/.bashrc source ~/.bashrc

验证安装是否成功:

ollama --version

如果遇到网络问题,可以尝试使用国内镜像源:

export OLLAMA_HOST=https://mirror.ollama.ai curl -fsSL https://ollama.ai/install.sh | env OLLAMA_HOST=$OLLAMA_HOST sh

3. 常见问题与优化配置

3.1 内存与交换空间管理

WSL2默认会占用大量内存,可以通过在用户目录下创建.wslconfig文件进行限制(Windows路径:C:\Users\<你的用户名>\.wslconfig):

[wsl2] memory=8GB swap=4GB localhostForwarding=true

重启WSL生效:

wsl --shutdown

3.2 文件系统性能优化

WSL2的Linux文件系统与Windows的互操作性较差,建议:

  1. 将项目文件存放在Linux文件系统中(如~/projects)
  2. 避免在/mnt/c等挂载目录下进行大量IO操作
  3. 对于需要频繁访问的Windows文件,可以使用wslpath命令转换路径:
# Windows路径转Linux路径 wslpath "C:\Users\MyUser\Documents"

3.3 Ollama模型管理技巧

Ollama支持多种AI模型,使用时注意:

# 列出可用模型 ollama list # 拉取模型(如LLaMA2) ollama pull llama2 # 运行模型 ollama run llama2

对于国内用户,可以使用镜像加速模型下载:

export OLLAMA_MODELS=https://mirror.ollama.ai/models

4. 进阶集成方案

4.1 与Windows宿主机的端口转发

默认情况下,WSL2中的服务可以通过localhost直接访问。例如启动Ollama的Web界面:

ollama serve

然后在Windows浏览器中访问http://localhost:11434即可。

如果需要自定义端口,可以在Windows防火墙中添加入站规则。

4.2 使用Windows Terminal获得更好体验

微软商店安装Windows Terminal后,可以:

  1. 配置Ubuntu为默认启动项
  2. 设置美观的字体和配色方案
  3. 添加多标签页支持

推荐配置:

// settings.json片段 { "profiles": { "defaults": { "font": { "face": "Cascadia Code", "size": 11 }, "colorScheme": "One Half Dark" }, "list": [ { "guid": "{2c4de342-xxx}", "name": "Ubuntu-22.04", "source": "Windows.Terminal.Wsl", "startingDirectory": "//wsl$/Ubuntu-22.04/home/username" } ] } }

4.3 与VS Code的深度集成

安装Remote - WSL扩展后:

  1. 在WSL终端中输入code .即可启动VS Code并连接到WSL环境
  2. 所有开发工具和扩展都可以直接在WSL环境中运行
  3. 调试时自动处理路径转换

对于Python开发,建议在WSL中创建独立的虚拟环境:

python -m venv ~/venvs/ollama source ~/venvs/ollama/bin/activate pip install -r requirements.txt

这样既保持了环境隔离,又能利用VS Code的强大功能。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询