张牛顿1. WSL环境准备与系统配置
在Windows Subsystem for Linux（WSL）上运行Ubuntu 24.04或Debian 13（trixie）时，首先需要确保基础环境配置正确。我最近在WSL2上完成了Mariadb 11.8.6的完整安装和C++开发环境搭建，这里分享一些关键步骤和注意事项。
1.1 WSL安装与初始化
对于Windows 10/11用户，建议使用WSL2而非WSL1，因为前者提供完整的Linux内核支持。安装步骤如下：
- 以管理员身份打开PowerShell，执行：
bash复制wsl --install -d Ubuntu-24.04
如果遇到安装缓慢问题，可以尝试先启用WSL组件：
bash复制dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- 安装完成后，建议立即更新系统：
bash复制sudo apt update && sudo apt upgrade -y
注意：如果遇到"无法启用VirtualMachinePlatform"错误（代码14098），需要检查BIOS中是否启用了虚拟化技术（Intel VT-x或AMD-V）
1.2 系统源配置
Ubuntu 24.04和Debian 13的软件源配置略有不同：
对于Ubuntu 24.04：
bash复制sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
对于Debian 13（trixie）：
bash复制sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo sed -i 's/security.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
更新软件包缓存：
bash复制sudo apt update
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. MariaDB 11.8.6安装与配置
2.1 安装MariaDB服务器
MariaDB 11.8是当前稳定版本，提供了许多性能改进和新特性。安装命令如下：
bash复制sudo apt install mariadb-server mariadb-client libmariadb-dev -y
验证安装版本：
bash复制mariadb --version
应显示类似"mariadb Ver 15.1 Distrib 11.8.6-MariaDB"的输出
2.2 安全初始化
运行安全脚本配置基本安全选项：
bash复制sudo mysql_secure_installation
关键配置点：
- 设置root密码（生产环境建议使用强密码）
- 移除匿名用户
- 禁止root远程登录
- 移除测试数据库
- 立即重载权限表
2.3 服务管理与故障排查
启动MariaDB服务：
bash复制sudo systemctl start mariadb
sudo systemctl enable mariadb
常见问题解决方案：
- 如果遇到"Failed to start mariadb.service"错误：
bash复制sudo rm /var/lib/mysql/ib_logfile*
sudo mysqld --initialize
sudo chown -R mysql:mysql /var/l