codespaces 不加速编译或执行，仅缩短环境就绪时间；“秒级”指30秒内完成容器拉起、依赖预装和代码挂载。启动慢需确认是新建还是连接操作，正确命令为codespaces: create new codespace，且须满足三个条件：打开本地克隆的github仓库文件夹、安装官方github.codespaces扩展、登录有权限的github账户。
VSCode 无法让超大规模工程“秒级运行”——Codespaces 本身不加速编译或执行，它只解决环境就绪时间；所谓“秒级”，实际是“30 秒内完成容器拉起 + 预装依赖 + 挂载代码”，而非代码跑得更快。
Codespaces 启动慢？先确认你触发的是「新建」还是「连接」
很多人误以为“秒级运行”指打开即用，结果在 VSCode 桌面端反复点 Codespaces: Connect to Codespace 却提示命令不存在。这个命令根本不能连上已有实例——它只存在于 VSCode for Web（github.dev 或 vscode.dev）中，且仅用于连接 GitHub 托管的 codespace 实例（非自建）。
真正能启动新环境的命令只有一个：Codespaces: Create New Codespace。但它是否可用，取决于三个硬条件：
- VSCode 必须打开一个本地
git clone出来的 GitHub 仓库文件夹（空目录、单文件、非 GitHub 仓库都不行） - 已安装官方
github.codespaces扩展（作者必须是 GitHub，不是 Remote - SSH 或其他名字近似的插件） - 左下角状态栏已登录 GitHub 账号，且该账号有 Codespaces 权限（免费用户每月 60 小时，私有仓库需 Pro/Team）
超大仓库首次加载卡在 “Waiting for container to start”？别等，换策略
Codespaces 默认挂载整个仓库，对 >10GB 的 mono-repo 或含大量二进制资产（如 .zip、.tar、历史大文件）的项目，拉取和解压会严重拖慢启动。这不是网络问题，是设计使然。
解决方案不是调高 CPU 规格，而是绕过全量同步：
- 在仓库根目录的
.devcontainer/devcontainer.json中启用"largeRepoOptimization": true（仅支持 GitHub-hosted codespaces） - 改用
"repository" + "ref"方式指定子路径，例如："repository": "owner/repo", "subPath": "packages/frontend"，避免加载无关模块 - 若必须加载全部，提前在
postCreateCommand中加git config --local core.sparseCheckout true并配置.git/info/sparse-checkout，跳过非必要目录
终端里 npm install 或 bazel build 还是慢？那不是 Codespaces 的锅
Codespaces 提供的是干净 Ubuntu 容器（如 ubuntu-22.04），不预装 Node.js、Bazel、Rust toolchain 等——你看到的“空”终端，就是它本来的样子。手动 apt install 或 curl | bash 装工具，下次重建容器就全丢。
正确做法是把构建依赖声明进环境定义：
- 用预构建镜像：比如
"image": "mcr.microsoft.com/vscode/devcontainers/javascript-node:18"，省去 npm 和 Node 安装时间 - 用
features声明工具链："features": { "ghcr.io/devcontainers/features/node:1-20": {} }，比写 shell 更稳定 - 对 Bazel/C++/Go 等重型工具，把
onCreateCommand设为./scripts/setup-dev-env.sh，并在脚本里用cache目录保存下载产物（Codespaces 会保留/workspaces/.codespaces下内容）
为什么改完 devcontainer.json 后代码没变快？你漏了重建步骤
修改 .devcontainer/devcontainer.json 不会热更新运行中的容器。VSCode 右下角显示 Codespace 标识，只代表连接成功，不代表配置已生效。
必须显式执行：Dev Containers: Rebuild Container（不是 Reload Window，也不是 Close Remote）。这个操作会销毁当前容器、拉取新镜像、重新运行 postCreateCommand，耗时通常比首次创建还长——但之后每次新建 codespace 都会复用该配置。
容易被忽略的一点：devcontainer.json 必须提交到仓库主分支的 .devcontainer/ 目录下。如果只存在本地未提交，或放在 devcontainer.json.bak 这类非标准路径，GitHub 自动识别和协作者同步都会失效。
