vscode 桌面版无法启动 codespaces，必须从 github 仓库页面触发并在浏览器中加载远程容器；“在 vscode 中打开”实为使用 vscode for web（github.dev）连接 github 托管的 linux 容器，需通过 open with codespaces 进入真环境，且依赖 devcontainer.json 配置运行时。
不能在 VSCode 桌面版里“运行代码”来启动 Codespaces —— 它必须从 GitHub 仓库页面触发，然后在浏览器中加载完整容器环境。
为什么“在 VSCode 中打开 Codespaces”这个说法本身就有误导
VSCode 桌面端没有内置 Codespaces 运行时。所谓“使用 VSCode”，实际是用 VSCode 的前端界面（即 VSCode for Web）连接到 GitHub 托管的 Linux 容器。这个界面只在两个地方真正生效：github.com/codespaces（列表页，不干活）和从仓库点 Open with Codespaces 后跳转的 github.dev 地址（带终端、Ports、调试面板的真环境）。
常见错误现象包括：
- 在桌面 VSCode 命令面板搜
Codespaces: Connect to Codespace报错 “command not found” —— 因为该命令仅在 VSCode for Web（浏览器版）中注册 - 手动访问
vscode.dev然后粘贴仓库链接 —— 这只是静态浏览，没容器、没终端、npm和python3都不可用 - 以为装了
GitHub Codespaces扩展就能本地“启动”一个 Codespace —— 扩展只负责创建/连接，底层容器始终由 GitHub 调度
在浏览器中真正跑起代码的最小可行路径
不是配置，不是安装，是三步点击流：
- 用 Safari 或 Chrome 打开任意 GitHub 仓库（比如
github.com/microsoft/vscode） - 点绿色
Code按钮 → 选Open with Codespaces→ 点Create codespace on main - 等待 20–60 秒，自动跳转到带完整侧边栏的
github.dev页面，此时终端可用、Ports面板可见、Run and Debug图标亮起
验证是否成功：打开集成终端，执行 which python3 或 node -v。有输出才说明容器已就绪；如果返回空，说明你还在 vscode.dev 静态模式，没进 Codespaces。
devcontainer.json 不写，代码很可能根本 run 不起来
Codespaces 默认镜像（如 ubuntu-22.04）只预装 git、wget、curl，不带 python3、node、dotnet 等运行时 —— 这和本地 macOS/Windows 完全不同。
必须靠 .devcontainer/devcontainer.json 声明依赖，否则：
-
npm run dev报command not found -
dotnet hello-world.cs提示dotnet: command not found - 即使你手动
sudo apt install python3，下次重建 codespace 又得重来
正确做法：在仓库根目录建 .devcontainer/devcontainer.json，内容至少包含 image 或 features 字段。例如 Python 项目可直接用官方 feature：
{
"image": "mcr.microsoft.com/devcontainers/python:3",
"features": {
"ghcr.io/devcontainers/features/python:1": {}
}
}
改完后必须执行 Codespaces: Rebuild Container（命令面板里搜），否则配置不生效。
终端里敲的每一行命令，其实都在远程 Ubuntu 容器里执行
你在浏览器中看到的终端，不是本机 shell，也不是 Docker Desktop 里的容器，而是 GitHub 分配给你的专属 ubuntu-22.04（或你指定的镜像）实例。这意味着：
-
git commit提交的是远程容器里的代码，不是你 iPad 本地文件系统 -
pip install requests装到的是容器的/usr/local/lib/python3.x/site-packages，重启 codespace 后若没写进devcontainer.json就会丢失 - 转发的端口（如
3000）显示为https://your-name-3000.githubpreview.dev，这是 GitHub 的反向代理，不是你本机localhost:3000
最容易被忽略的一点：Codespaces 的“重启”不是刷新网页，而是重建整个容器 —— 它会丢掉所有未提交的改动、未保存的终端历史、未持久化的 node_modules。别指望它像本地开发一样随手改随手试。
