GitHub Codespaces 无法在 VSCode 桌面端通过“Connect to Codespace”打开，因该命令仅适用于 VSCode for Web（github.dev）；正确方式是：在 GitHub 仓库页点击“Open with Codespaces”，或在桌面端安装官方扩展后使用“Create New Codespace”。
GitHub Codespaces 在 VSCode 桌面端打不开？先确认你没点错入口
Codespaces 本质是云端容器，不是本地插件——你在 VSCode 桌面版里直接按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），搜 Codespaces: Connect to Codespace 是无效的。这个命令只在 VSCode for Web（也就是浏览器里打开的 vscode.dev 或 github.dev）中可用。
真正能连上 Codespaces 的路径只有两条：
- 在 GitHub 仓库页面点击
Code→Open with Codespaces→ 选择或新建环境，自动跳转到github.dev网页版 VSCode - 在 VSCode 桌面端装好
GitHub Codespaces扩展（官方出品，作者GitHub），然后用Codespaces: Create New Codespace命令启动——它会新开一个桌面端窗口，但底层仍是远程容器
常见错误现象：Command 'Codespaces: Connect to Codespace' not found，大概率是因为扩展没装，或者你正处在未登录 GitHub 账号的 VSCode 实例里。
VSCode for Web（github.dev）和 Codespaces 的关系到底是什么
github.dev 是轻量级浏览器版编辑器，打开任意 GitHub 仓库就能用，不启动容器，不能运行终端、不加载扩展、不支持调试；而 github.com/codespaces 或从仓库点 Open with Codespaces 进入的，才是完整 Codespaces 环境——它用的也是 VSCode for Web 界面，但背后挂载了专属 Linux 容器、预装了开发工具链、可执行 git、npm、python 等命令。
关键区别就一条：有没有出现在左侧活动栏的 Ports、Terminal、Run and Debug 面板。没有？你只是在 github.dev；有？你已经在 Codespaces 里了。
性能影响：浏览器版 Codespaces 对网络延迟敏感，如果 Waiting for container to start... 卡住超过 90 秒，大概率是区域节点调度失败，刷新页面或换浏览器重试更有效，别急着改配置。
本地 VSCode 桌面端连 Codespaces，为什么终端里 which python 返回空
Codespaces 默认镜像（如 ubuntu-22.04）不预装 python，这点和本地 macOS 或 Windows 不同。你看到的终端是容器里的 shell，不是你本机的。
解决办法很简单，但容易被忽略：
- 首次打开终端后，先运行
sudo apt update && sudo apt install -y python3 python3-pip（Ubuntu 镜像） - 如果要用
python命令而非python3，再加一步：sudo ln -sf /usr/bin/python3 /usr/bin/python - 想持久化？把安装命令写进
.devcontainer/devcontainer.json的features或onCreateCommand字段里
兼容性注意：不同基础镜像（debian、centos-stream-9）包管理器命令不同，apt 在 CentOS 里会报错，得用 dnf。查当前系统用 cat /etc/os-release 最稳。
修改 .devcontainer.json 后，怎么让 Codespaces 重新构建容器
改完配置文件不会自动重装——Codespaces 只在创建时读一次 .devcontainer.json。要生效，必须重建容器。
实操步骤很直接：
- 在 Codespaces 界面按
Ctrl+Shift+P/Cmd+Shift+P，输入Dev Containers: Rebuild Container - 或者点击左下角远程指示器（显示
Codespaces字样），选Rebuild Container
容易踩的坑：Rebuild without cache 不是默认选项，如果你改了基础镜像或安装了大体积依赖，缓存可能让你看不到新变化，这时候得手动勾选它；另外，重建期间所有未保存的终端、调试会话都会断开，但文件自动保存，不用慌。
复杂点在于：一旦你用了自定义 Dockerfile，Rebuild Container 会重新 docker build，耗时可能长达几分钟——这时候盯着右下角通知比反复刷页面更靠谱。
