vscode 在 codespace 中运行于云端容器，文件、终端、扩展、调试器均在远程；入口仅限 github.dev 或桌面版 vscode 通过官方扩展新建独立窗口；命令“connect to codespace”仅存在于浏览器端。
VSCode 在 Codespace 中开发，不是“打开本地 VSCode 然后连上远程”，而是你操作的 VSCode 实例（无论网页版还是桌面版）**本质运行在云端容器里**——文件、终端、扩展、调试器全在远程。搞错这点，90% 的连接失败和行为异常就都有了。
Codespace 启动后，VSCode 界面到底在哪？
Codespace 没有“本地客户端”概念。它只有两个合法入口：
- 在 GitHub 仓库页点击
Code→Open with Codespaces→ 创建或选择实例，自动跳转到github.dev（即 VSCode for Web） - 在已安装
GitHub Codespaces官方扩展的桌面版 VSCode 中，执行Codespaces: Create New Codespace，它会新开一个独立窗口，但底层仍是远程容器，不是本地进程
常见错误：Command 'Codespaces: Connect to Codespace' not found —— 这个命令只存在于 github.dev 或 vscode.dev 浏览器环境，**桌面版 VSCode 默认不提供该命令**，装了扩展也不行。别搜这个命令，它根本不存在于桌面端上下文。
为什么终端里看不到 git 配置或 npm 全局模块？
Codespace 是干净的 Linux 容器（默认 Ubuntu），每次新建都重置，不会继承你本地的 ~/.gitconfig、npm global 或 shell history。必须显式配置：
- 首次连接后，在集成终端中运行
git config --global user.name "YourName"和git config --global user.email "you@example.com" - 全局安装工具要用
npm install -g xxx，但注意：Codespace 默认不挂载/home/codespace/.npm持久化，重启后丢失；如需保留，得在devcontainer.json里配postCreateCommand或用settings.json开启npm.enableScripts - 环境变量不能靠本地
.zshrc自动加载，必须写进devcontainer.json的remoteEnv或容器启动脚本
如何让本地 VSCode 设置（比如 Prettier、ESLint）在 Codespace 里生效？
设置同步不是自动开启的。必须手动做三件事：
- 在本地 VSCode 中：左下角齿轮 →
Turn on Settings Sync→ 用 GitHub 账号登录，并勾选Extensions、Settings、Keybindings - 首次连接 Codespace 后，VSCode 会弹出
Apply settings from your settings sync?提示，点Yes（不点就不会同步） - 某些扩展（如 Live Server、C/C++ IntelliSense）依赖本地二进制或 GUI，Codespace 会静默跳过；可在通知中心查看被禁用的扩展列表，改用纯 Web/CLI 替代方案（如
esbuild替代 Live Server）
别指望 settings.json 里的 "editor.formatOnSave": true 自动触发 Prettier——如果没同步扩展，格式化功能根本不可用。
devcontainer.json 是什么？为什么改了它，Codespace 重建才生效？
devcontainer.json 不是配置文件，它是 **Codespace 的构建蓝图**。它决定：
- 用哪个 Docker 镜像（
image）或Dockerfile - 容器启动时执行什么命令（
postCreateCommand），比如npm install或pip install -r requirements.txt - 哪些端口要转发（
forwardPorts），比如3000、8080 - 是否挂载本地目录（
mounts）、是否启用 GPU（customizations.vscode.extensions）
关键点：修改 devcontainer.json 后，必须 重建 Codespace（Rebuild Container），否则改动完全不生效。按 Cmd+Shift+P → Dev Containers: Rebuild Container，而不是重启 VSCode 或刷新页面。
最常被忽略的是：Codespace 的「挂起」不等于「关闭」。挂起后容器还在后台计费，且下次唤醒可能丢掉未提交的 devcontainer.json 修改——务必先 git add && git commit 再挂起。
