跳到主要内容

0.相关文档

什么是适用于 Linux 的 Windows 子系统

安装 WSL

WSL 的基本命令

1.WSL介绍

什么是 WSL？

适用于 Linux 的 Windows 子系统（WSL）是 Windows 的一项功能，可用于在 Windows 计算机上运行 Linux 环境，而无需单独的虚拟机或双重启动。 WSL 旨在为想要同时使用 Windows 和 Linux 的开发人员提供无缝高效的体验。

WSL可以支持哪些Linux系统？

使用 WSL 安装和运行各种 Linux 分发版，例如 Ubuntu、Debian、Kali 等。 安装 Linux 分发版 并从 Microsoft 应用商店接收自动更新， 导入 Microsoft 应用商店中不可用的 Linux 分发版，或 生成自己的自定义 Linux 分发版。

WSL 和 VM 虚拟机有什么区别？

WSL 是Windows系统原生的功能，使用虚拟化技术在轻型实用工具虚拟机（VM）内运行 Linux 内核。可以理解为将 Linux系统作为Windows的一种程序来运行，执行效率非常高，可以秒级启动，并且还可以与 Windows文件系统互相访问，并且可以网络互通。

2.安装WSL及Ubnutu虚拟机

先决条件：

必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。 这一点 99% 的人都满足

安装 WSL 组件：

首先需要先安装 WSL 的组件包，在线安装速度很慢，建议直接从官方Github仓库下载最新版

wsl.2.6.1.0.x64.msi.zip

开启虚拟化功能，执行完之后需要重启：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台功能
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

在线安装 Ubuntu 虚拟机（慢）：

安装完成WSL之后就可以使用以下命令安装 Linux操作系统了，这里安装最新版的Ubuntu 24.04 LTS

右键单击并选择“以管理员身份运行”，在 管理员 模式下打开 PowerShell 或 Windows 命令提示符，输入 wsl --install 命令。

wsl --install -d Ubuntu-24.04

注意：

  • 默认参数安装的Ubuntu虚拟机磁盘是保存在 C 盘的，后续我们可以导出迁移到其他盘
  • 首次安装完成后会提示你输入普通账号和密码
  • 安装完Ubuntu是终端界面里会自动创建 Ubuntu 的连接选项
  • 安装完Ubuntu成后会出现一个管理菜单，可以在图形界面上配置很多选项

离线导入 Ubuntu 虚拟机（快）：

上面的步骤是在线安装 Ubuntu 虚拟机，安装速度可能较慢，我们也可以采用其他电脑安装好的虚拟机导出后的压缩包直接导入到本地的 WSL，百度网盘地址：

success

通过网盘分享的文件：VMUbuntu-24.04.tar

链接: https://pan.baidu.com/s/1V39KsJP-r6AB8BXicE93xQ?pwd=xr4b 提取码: xr4b

--来自百度网盘超级会员v9的分享

将压缩包保存到本地后使用以下命令导入，可以修改虚拟机名称和保存路径：

# 语法格式
wsl --import 虚拟机名称 虚拟机目录 虚拟机镜像压缩包路径.tar

# 导入命令
wsl --import Ubuntu-dev D:\WSL\Ubuntu-Custom D:\WSL_Backup\Ubuntu.tar

账号密码信息：

普通账号：zhangya

密码：123

修改 root 密码命令：

sudo password root

3.WSL基础使用命令

# 列出已安装的Linux发行版
wsl -l

# 列出已安装的发行版及其状态
wsl -l -v

# 启动默认WSL发行版,直接进入Ubuntu终端界面
wsl

# 启动指定名称的发行版
wsl -d Ubuntu-Dev

# 关闭所有WSL实例
wsl --shutdown

4.安装开发必备环境

wsl_setup.sh

这里直接使用AI 写好的脚本一键安装，将会在/opt目录下以二进制的形式安装以下软件并配置好环境变量：

  • node
  • jdk8
  • go

安装 Docker并拉取以下镜像：

  • Nginx
  • MySQL 8.0
  • Redis

效果如下：

5.选择一个靠谱的VPN

严重推荐这个非常稳定价格实惠的VPN平台，可以先选择20/月试用，以下是我的推广链接

https://wd-gold.com/aff.php?aff=10498

然后安装 VPN 的客户端：

https://github.com/clash-verge-rev/clash-verge-rev/releases

最后记得一定要打开tun代理模式虚拟机才能访问外网：

如果是老版本的Clash需要先安装服务模式，之后才能开启TUN模式

6.安装ClaudeCode

前提条件是先安装好了node环境，安装命令很简单，一条即可

# 检查node环境
node -v

# 安装ClaudeCode
npm install -g @anthropic-ai/claude-code

# 检查ClaudeCode
claude -v

# 启动ClaudeCode
claude

注意：如果启动后没有进入claude界面而是返回了桌面，原因是没有VPN开启tun翻墙模式

开启tun模式之后应该就可以了，另外注意！VPN节点不能选择亚洲国家，否则依然会被拒绝！

如果出现选择界面风格，就证明Claude配置好了

下一步会弹出让你登录，如果是终端没有UI界面也没关系，复制终端提示给你的URL到浏览器即可认证

选择通过认证

选择后会提示你复制一串码到终端

返回Claude终端，粘贴刚才的代码

此时就提示登录成功了

然后按回车会有一个提醒，继续按回车

继续按回车

然后就可以正式对话了

7.风险注意

WSL方式安装的Linux系统，会默认将Windows系统的所有磁盘都挂载到/mnt目录下

那也就意味着一件非常危险事情，就是在WSL安装的Ubnutu系统里是可以删除Windows上的文件的，所以非常不建议在/mnt/目录下进行操作，因为很容易误伤Windows！！！

有同学会说，那如果我想传输文件到windows怎么办？其实并不需要特别操作，因为文件共享是双向的，也就是说其实Windows下也可以访问WSL的Ubuntu文件，打开资源管理器就可以看到Ubuntu的网络文件夹，打开就可以访问Ubuntu文件了。

附录：WSL常用命令

WSL启动和关闭命令

# 启动默认WSL发行版
wsl

# 启动特定发行版
wsl -d <发行版名称>
wsl --distribution <发行版名称>

# 在特定发行版中执行命令
wsl -d <发行版名称> <命令>

# 启动WSL并直接进入指定目录
wsl --cd <目录路径>

# 关闭所有WSL实例
wsl --shutdown

# 终止特定发行版
wsl --terminate <发行版名称>
wsl -t <发行版名称>

# 重启WSL服务（需要在PowerShell管理员权限下运行）
Restart-Service LxssManager

WSL管理命令

# 列出已安装的Linux发行版
wsl --list
wsl -l

# 列出已安装的发行版及其状态
wsl --list --verbose
wsl -l -v

# 列出所有可用的发行版（在线）
wsl --list --online
wsl -l -o

# 安装新的Linux发行版
wsl --install <发行版名称>

# 设置默认发行版
wsl --set-default <发行版名称>

# 卸载发行版
wsl --unregister <发行版名称>

版本和转换命令

# 设置WSL版本 (WSL1或WSL2)
wsl --set-version <发行版名称> <版本号>

# 设置默认WSL版本
wsl --set-default-version <版本号>

# 检查WSL状态
wsl --status

导入导出命令

# 导出发行版为tar文件
wsl --export <发行版名称> <文件路径.tar>

# 例如：导出Ubuntu到D盘
wsl --export Ubuntu D:\WSL_Backup\Ubuntu.tar

# 从tar文件导入发行版到自定义位置
wsl --import <新发行版名称> <自定义安装路径> <文件路径.tar>

# 例如：从备份恢复Ubuntu到自定义位置
wsl --import Ubuntu-Custom D:\WSL\Ubuntu-Custom D:\WSL_Backup\Ubuntu.tar

# 指定WSL版本导入（可选）
wsl --import <新发行版名称> <安装路径> <文件路径.tar> --version <版本号>

完整的备份和恢复示例

# 1. 导出现有的Ubuntu发行版
wsl --export Ubuntu D:\Backup\Ubuntu-20241213.tar

# 2. 导入到新位置，命名为Ubuntu-Dev
wsl --import Ubuntu-Dev D:\WSL\Ubuntu-Dev D:\Backup\Ubuntu-20241213.tar

# 3. 设置为默认发行版（可选）
wsl --set-default Ubuntu-Dev

# 4. 启动新导入的发行版
wsl -d Ubuntu-Dev

# 注意事项：
# - 导出前建议关闭WSL：wsl --shutdown
# - 自定义安装路径的目录会自动创建
# - 导入后需要重新配置默认用户（如果需要）
# - 可以同时存在多个同一发行版的不同实例

文件系统访问

# 在Windows中访问WSL文件系统
\\wsl$\<发行版名称>\

# 在WSL中访问Windows文件系统
/mnt/c/  # C盘
/mnt/d/  # D盘

用户管理

# 以特定用户身份运行
wsl -u <用户名>

# 以root用户身份运行
wsl -u root

网络相关

# 查看WSL IP地址
wsl hostname -I

# 从Windows访问WSL服务
localhost:<端口号>

更新和维护

# 更新WSL
wsl --update

# 检查WSL版本
wsl --version
最后于 更新