WSL

身份 非官方简体中文镜像

翻译状态 AI 翻译

来源版本 官方未提供

同步日期 2026-07-31

官方原文 learn.chatgpt.com

如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加 .md 来获取 URL。

当你使用 WSL2时， Codex 会在 Linux 环境中运行，而不是使用 原生 Windows 沙箱。在你需要 Linux 原生 WSL2 工具链、你的仓库和开发工作流已经位于 中，或者 WSL2两种原生 Windows 沙箱模式都不适用于你的环境时，请选择 。

WSL1 曾通过 Codex 0.114受到支持。从 Codex 0.115开始，Linux 沙箱已迁移到 bubblewrap，因此 WSL1 不再受支持。

从 VS 内部启动 Code WSL

如需分步说明，请参阅 官方 VS Code WSL 教程。

前提条件

• 已安装 WSL 的 Windows。要安装 WSL，请以管理员身份打开 PowerShell ，然后运行 wsl --install （Ubuntu 是常见选择）。
• VS 已安装 WSL 扩展 的 Code。

打开 VS 来自 WSL 终端的代码

# From your WSL shell
cd ~/code/your-project
code .

这会打开一个 WSL 远程窗口，按需安装 VS Code Server，并确保集成终端在 Linux 中运行。

确认你已连接到 WSL

• 查看显示 WSL: <distro>的绿色状态栏。
• 集成终端应显示 Linux 路径（例如 /home/...），而不是 C:\。
• 你可以用以下命令验证：

  echo $WSL_DISTRO_NAME

这会打印你的发行版名称。

如果你没有在状态栏中看到“WSL：…”，请按 Ctrl+Shift+P，选择 WSL: Reopen Folder in WSL，并将你的仓库保存在 /home/... 下（不要放在 C:\）以获得最佳性能。

如果 Windows 应用或项目选择器未显示你的 WSL 仓库，请在文件选择器或资源管理器中输入 `\wsl如果 Windows 应用或项目选择器未显示你的 WSL 仓库，请在文件选择器或资源管理器中输入 ，然后导航到你的 发行版主目录。

将 Codex CLI 与 WSL

从提升权限的 PowerShell 或 Windows Terminal 运行这些命令：

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

然后从你的 WSL shell 运行这些命令：

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

在 WSL

• 在像 /mnt/c/... 这样的 Windows 挂载路径中工作，可能比在 Windows 原生路径中工作更慢。将你的仓库保存在 Linux 主目录下（例如 ~/code/my-app），以获得更快的 I/O 并减少符号链接和权限问题：

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• 如果你需要从 Windows 访问文件，它们位于资源管理器中的 \\wsl$\Ubuntu\home\<user> 下。

故障排除和 FAQ

大型仓库在 WSL

• 确保你不是在 /mnt/c下工作。将仓库移动到 WSL （例如 ~/code/...）。
• 如有需要，增加 CPU 的内存和 WSL ；将 WSL 更新到最新版本：

  wsl --update
  wsl --shutdown

VS 中的 Code WSL 找不到 codex

验证二进制文件是否存在，并且在 PATH 内部位于 WSL中：

which codex || echo "codex not found"

如果找不到二进制文件，请按照 Codex CLI 设置说明操作。