Terax WSL配置指南在Windows上获得完整Linux开发体验【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-aiTerax 是一款仅 7MB 的终端优先 AI 原生开发工作区Tauri 2 Rust React 19 构建其逐标签工作区环境让你可以在同一个终端里自由切换 Windows 本地 Shell 与任意 WSL 发行版。本指南将带你在 Windows 上完成 WSL 配置让终端、AI 智能体和文件资源管理器全部跑在完整的 Linux 环境中——无需虚拟机无需 Docker。为什么在 Windows 上需要 Terax WSL很多开发者习惯 Linux 工具链bash、zsh、Linux 版 Python/Node却不想离开 Windows。传统方案要么用虚拟机笨重要么在 Git Bash 里将就用功能残缺。Terax 把WSL 作为一等工作区环境处理而不是封装的子进程见 README.zh-CN.md 的 Windows 说明。这意味着✅ 每个标签页可独立选择运行环境Windows 本地 或 某个 WSL 发行版✅ WSL 空间内自动使用发行版的登录 Shellzsh/bash/fish 均支持✅ AI 智能体Agent在 WSL 里执行命令工具链与你日常开发一致✅ 文件路径自动映射/mnt/c/Users/...会自动转换为 Windows 原生盘符路径避免 UNC 共享拒绝访问的老问题实现见 workspace.rs第一步在 Windows 上安装 WSL 发行版 如果系统还没装 WSL只需两条命令在管理员 PowerShell 中执行wsl --install # 一键安装 WSL 默认 Ubuntu wsl --list --verbose # 确认发行版状态为正在运行/已停止想装其他发行版Debian、openSUSE 等可用wsl --list --online查看可用列表。安装完成后重启一次电脑即可。 Terax 通过wsl.exe --list自动发现所有已安装发行版无需手动填写。第二步安装 TeraxTerax 是轻量级 AI 开发工作区Windows 构建已使用 SignPath 免费证书签名。你可以从 Releases 页面下载安装包应用会自动更新也可以从源码构建git clone https://gitcode.com/GitHub_Trending/te/terax-ai cd terax-ai pnpm install pnpm tauri buildWindows 上本地环境的默认 Shell 检测顺序为pwsh.exePowerShell 7→powershell.exe→cmd.exe。第三步一键选择 WSL 环境Terax 提供两个入口选择工作区环境1. 状态栏环境选择器切换单个空间在窗口状态栏点击工作区环境选择器会列出Windows本地和所有已检测到的 WSL 发行版例如WSL: Ubuntu。切换后新的空间就会在该环境里运行。选择器逻辑见 WorkspaceEnvSelector.tsx。2. 全局默认环境Settings → General在设置 → General中配置新空间在哪里运行Windows 本地终端和 AI 智能体都在 Windows 侧执行WSL: 发行版新空间的终端与 AI 智能体全部跑在该 Linux 发行版内相关设置界面源码在 GeneralSection.tsx。注意一个贴心细节已有空间会保持它们原来的环境不会被批量改写避免你正在跑的任务被搬走。第四步开箱即用的 Linux 开发体验 切换到 WSL 环境后一切自动就位Shell 集成自动配置Terax 会探测发行版的登录 Shellwsl_login_shell并为 zsh/bash/fish 自动准备集成脚本提示符捕获、光标位置等启动方式见 shell_init.rs。你不需要手动改.zshrc或.bashrc。文件操作零摩擦文件资源浏览器的模糊搜索、重命名、拖拽都作用于 Linux 侧文件系统拖文件进终端时路径会自动做 shell 安全引用空格路径也不会出错。AI 智能体在 Linux 里干活打开 AI 侧边栏智能体的文件读写、grep、bash 命令全部在 WSL 内执行——ls -la、make、cargo build这些 Linux 习惯照用不误。API 密钥通过系统钥匙串keyring存储不落磁盘。常见问题速查问题说明环境列表显示 No WSL distros foundWSL 未安装或没有发行版先执行wsl --install后重启显示 WSL unavailable确认 WSL 功能已启用wsl --status可检查想同时开本地和 WSL 标签完全可以逐标签独立环境互不影响设置里的发行版显示 (unavailable)该发行版已被卸载切换回有效选项即可小结Terax 的 WSL 配置指南总结起来只有三步装好 WSL 发行版 → 安装 Terax → 在状态栏或 General 设置里选择 WSL 环境。之后你就拥有了完整的 Linux 开发体验原生 Shell、Linux 工具链、AI 智能体全部在一个 7MB 的轻量工作区里。 延伸阅读架构文档PTY 与 Shell 集成pty-shell-integration.mdWSL 路径映射与安全校验workspace.rs工作区环境前端状态env.ts中文功能总览README.zh-CN.md【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考