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

[个人笔记] WSL 完整使用指南及 Claude Code 配置记录

[个人笔记] WSL 完整使用指南及 Claude Code 配置记录

📝 说明

本文档仅作为个人技术笔记记录,部分内容可能已过时。

特别是 Claude Code 相关的安装配置,新版本已支持直接在 Windows 上安装,无需通过 WSL 环境。本文记录的是早期版本需要 WSL 的安装方法,现已不再适用。

WSL 相关的配置和使用方法仍然有效,可作为 Windows 开发环境配置的参考。


1. 安装配置

1.1 自动安装 WSL(推荐)

以管理员身份运行 PowerShell:

wsl --install

1.2 设置 WSL2 为默认版本

wsl --set-default-version 2

1.3 安装 Linux 发行版

# 查看可用的发行版
wsl --list --online
wsl -l -o# 安装默认的 Ubuntu
wsl --install# 安装指定发行版
wsl --install -d Ubuntu-24.04

2. 基本管理命令

2.1 查看已安装的发行版

# 简单列表
wsl --list
wsl -l# 详细信息(包括版本和状态)
wsl --list --verbose
wsl -l -v

2.2 启动和停止

# 启动默认发行版
wsl# 启动指定发行版
wsl -d Ubuntu# 关闭所有 WSL 实例
wsl --shutdown# 终止指定发行版
wsl --terminate Ubuntu

2.3 设置默认发行版

wsl --set-default Ubuntu

3. 备份和迁移

3.1 导出发行版(备份)

# 创建备份目录
mkdir D:\Program\WSL# 导出 Ubuntu 为 tar 文件
wsl --export Ubuntu D:\Program\WSL\wsl-ubuntu24.04.tar

3.2 注销发行版

# 注意:这会删除所有数据
wsl --unregister Ubuntu

3.3 导入发行版(恢复/迁移)

# 从备份文件导入新的发行版
wsl --import Ubuntu D:\Program\WSL\wsl-ubuntu24.04 D:\Program\WSL\wsl-ubuntu24.04.tar

4. 目录迁移详细步骤

4.1 完整迁移流程

# 1. 导出当前发行版
wsl --export Ubuntu G:\WSL\wsl-ubuntu24.04.tar# 2. 注销当前发行版
wsl --unregister Ubuntu# 3. 导入到目标目录
wsl --import Ubuntu G:\WSL\wsl-ubuntu20.04 G:\WSL\wsl-ubuntu24.04.tar# 4. 验证迁移
wsl --list --verbose

5. WSL 内部环境配置

5.1 进入 WSL 终端

# 在 Windows Terminal 或 PowerShell 输入
wsl

5.2 系统更新

# 更新软件包列表
sudo apt update# 升级已安装的软件包
sudo apt upgrade

5.3 查看系统信息

# 查看 Ubuntu 版本
lsb_release -a# 查看内核版本
uname -r# 查看系统资源
htop

6. 开发环境配置

6.1 Node.js 和 npm 安装

# 方法1:使用 apt 安装
sudo apt install nodejs npm# 方法2:使用 NodeSource 官方源(推荐)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs# 验证安装
node --version
npm --version

6.2 Python 环境

# 安装 Python 3 和 pip
sudo apt install python3 python3-pip# 验证安装
python3 --version
pip3 --version

6.3 Git 配置

# 安装 Git
sudo apt install git# 配置用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

7. Claude Code 安装(历史记录 - 已过时)

⚠️ 重要提醒:Claude Code 新版本已支持直接在 Windows 上安装,无需通过 WSL 环境。以下内容仅作为历史记录保存,展示早期版本的复杂安装过程。

7.1 NPM 配置(早期版本需要)

# 配置 npm 全局安装目录(可选)
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc# 配置 npm 平台
npm config set os linux

7.2 安装 Claude Code(早期版本方法)

# 全局安装
npm install -g @anthropic-ai/claude-code# 如遇权限问题
sudo npm install -g @anthropic-ai/claude-code# 如遇平台识别问题
npm install -g @anthropic-ai/claude-code --force --no-os-check

7.3 启动 Claude Code(早期版本方法)

# 进入项目目录
cd /mnt/c/your/project/path# 启动 Claude Code
claude

现在的安装方式:Claude Code 新版本支持直接在 Windows 上安装,无需上述复杂配置。请查看官方文档获取最新安装方法。

8. 文件系统和路径

8.1 Windows 文件系统访问

# 访问 C 盘
cd /mnt/c/# 访问 D 盘
cd /mnt/d/# 访问用户目录
cd /mnt/c/Users/YourUsername/

8.2 WSL 与 Windows 路径转换

# WSL 路径转 Windows 路径
wslpath -w /home/username/project
# 输出:\\wsl$\Ubuntu\home\username\project# Windows 路径转 WSL 路径
wslpath -u "C:\Users\YourName\Documents"
# 输出:/mnt/c/Users/YourName/Documents

9. VS Code 集成

9.1 安装 Remote-WSL 扩展

在 VS Code 扩展市场搜索并安装 “Remote - WSL”

9.2 在 WSL 中使用 VS Code

# 在当前目录打开 VS Code
code .# 打开特定文件
code filename.js

10. 性能优化

10.1 内存和 CPU 限制

创建或编辑 %USERPROFILE%\.wslconfig 文件:

[wsl2]
memory=4GB
processors=2
swap=2GB

10.2 网络配置

# 查看网络配置
ip addr show# 测试网络连接
ping google.com

11. 常见问题解决

11.1 权限问题

# 修改文件权限
chmod +x filename# 修改目录权限
chmod -R 755 directory/

11.2 服务管理

# 启动服务
sudo systemctl start service_name# 停止服务
sudo systemctl stop service_name# 查看服务状态
sudo systemctl status service_name

11.3 网络问题

# 重置网络
sudo systemctl restart systemd-networkd# 清理 DNS 缓存
sudo systemctl restart systemd-resolved

12. 实用命令汇总

12.1 WSL 管理

# 查看 WSL 状态
wsl --status# 更新 WSL
wsl --update# 查看版本
wsl --version# 设置默认用户
ubuntu config --default-user username

12.2 系统监控

# 查看磁盘使用
df -h# 查看内存使用
free -h# 查看进程
ps aux# 实时监控
top

12.3 包管理

# 搜索包
apt search package_name# 安装包
sudo apt install package_name# 卸载包
sudo apt remove package_name# 清理缓存
sudo apt autoremove
sudo apt autoclean

13. 备份策略

13.1 定期备份

# 创建定期备份脚本
$date = Get-Date -Format "yyyy-MM-dd"
wsl --export Ubuntu "D:\WSL\Backup\ubuntu-backup-$date.tar"

13.2 项目备份

# 备份重要配置
tar -czf ~/backup-$(date +%Y%m%d).tar.gz ~/.bashrc ~/.profile ~/.gitconfig

注意事项

  1. 数据安全:导出/导入操作会影响整个发行版,请提前备份重要数据
  2. 版本兼容:确保 WSL 版本与目标发行版兼容
  3. 性能考虑:WSL2 在某些 I/O 操作上可能比原生 Linux 慢
  4. 网络限制:WSL 的网络配置可能需要额外设置
  5. 更新频率:定期更新 WSL 和 Linux 发行版以获得最新功能和安全补丁

这份指南涵盖了 WSL 的基本使用、高级配置和常见问题解决方案,适合作为日常参考文档。

http://www.dtcms.com/a/278514.html

相关文章:

  • 019_工具集成与外部API调用
  • 【HarmonyOS】元服务概念详解
  • ubuntu系统在线安装postgres
  • 【视频格式转换】.264格式转为mp4格式
  • React Three Fiber 实现 3D 模型视图切换、显隐边框、显隐坐标轴
  • R 语言科研绘图第 64 期 --- 哑铃图
  • Python 基础语法2:组合数据类型、异常
  • Kafka——集群核心参数配置
  • TensorFlow深度学习实战(26)——生成对抗网络详解与实现
  • [Dify]-进阶1- Dify 支持的多种 AI 模型解析与选择建议
  • 排序算法(二):插入排序
  • 数据安全防护技术:筑牢信息安全防线
  • IoC容器深度解析:架构、原理与实现
  • 区块链开发协作工具全景图:从智能合约管理到去中心化治理
  • LabVIEW浏览器ActiveX事件交互
  • Oracle物化视图函数使用注意事项
  • 新型eSIM攻击技术可克隆用户资料并劫持手机身份
  • AWS RDS PostgreSQL可观测性最佳实践
  • crawl4ai--bitcointalk爬虫实战项目
  • ubuntu安装kafka(无zk版本)
  • Leaflet面试题及答案(81-100)
  • linux打包固件shell脚本
  • 打开xmind文件出现黑色
  • 理解Linux文件系统:从物理存储到统一接口
  • 【第一章编辑器开发基础第二节编辑器布局_3GUI元素和布局大小(3/4)】
  • 一般的非线性规划求解(非凸函数)
  • 自定义类型 - 联合体与枚举(百度笔试题算法优化)
  • 《C++初阶之STL》【泛型编程 + STL简介】
  • Spring原理揭秘--初识AOP
  • Spring 学习笔记