WSL

在 WSL2 中使用 Linux 工具链，并分清 Windows 与 Linux 的配置和路径。

何时使用 WSL2

仓库、工具和开发工作流位于 Linux 时，WSL2 可提供匹配的执行环境。它拥有独立的 Linux 用户目录、依赖、进程与权限；不会自动继承 Windows 桌面客户端的配置、登录和会话。

先由用户或 IT 按 Microsoft 的 WSL 文档安装并启用 WSL2。系统安装、更新与关闭发行版可能影响其他任务，执行前确认范围。Lime 不通过专有 IDE 扩展来完成这一步。

powershell

wsl --list --verbose

查看目标发行版与版本，再进入相应 Linux Shell。不要依赖其他产品的版本分界来判断 Lime 的 WSL1 兼容；使用 WSL2 并验证当前隔离实现。

在 WSL 内安装匹配架构的 Lime CLI 及其运行组件，使用 Lime 的正式下载或组织分发入口。不要执行其他产品的安装脚本。

bash

uname -m
command -v lime
lime --version
lime --cd "$HOME/code/project"

确认启动的是 Linux 可执行程序，而不是由 PATH 意外解析到 Windows 的 lime.exe。

使用 Linux 工具链时，优先将代码放在 Linux 主目录，例如 ~/code/project，降低跨文件系统的 I/O、权限与符号链接差异。Windows 工具链项目则保留在 Windows 文件系统并使用原生执行。

从 Windows 文件资源管理器访问 WSL 时，使用系统提供的发行版入口。移动已有仓库前保存改动，并检查依赖与工具是否引用旧绝对路径。

你可以使用支持 WSL 远程开发的编辑器打开 Linux 项目。以 VS Code 为例，在 WSL Shell 进入目录后运行 code .，再确认编辑器连接的是目标发行版，终端使用 /home/... 路径。

bash

cd "$HOME/code/project"
printf "%s\n" "$WSL_DISTRO_NAME"
code .

这是编辑器自身的 WSL 能力，不表示 Lime 提供 IDE 扩展或自动选区共享。通过明确文件、差异与项目目录给 Lime 上下文。

Windows 用户配置、Linux 用户配置和远程 App Server 配置分别管理。不要将认证缓存目录软链接或同步到另一个环境来绕过身份边界。需要复用任务时连接明确的同一运行组件，并核对远端目录与权限。

Lime 当前不提供桌面原生/WSL 智能体切换器的保证；在目标 Linux 环境运行 CLI 是明确的操作方式。

更新或关闭 WSL 会影响正在运行的进程。先保存工作并停止相关任务，再按 Microsoft 文档维护。