VS Code

前提条件

1. VS Code
2. Dev Containers 扩展 (ms-vscode-remote.remote-containers)
3. 在您的机器上运行 Docker 或 Podman（参见快速入门）。VS Code Dev Containers 也支持将 Podman 作为后端。

快速开始

git clone https://github.com/f5-sales-demo/devcontainer.git
code devcontainer

VS Code 检测到 .devcontainer/devcontainer.json 并显示通知：“在容器中重新打开”。点击它，或使用命令面板：

Dev Containers: Reopen in Container

VS Code 会构建（或拉取）镜像、启动容器、安装扩展，并在容器内打开终端。

工作原理

.devcontainer/devcontainer.json 文件告诉 VS Code 使用 Docker Compose：

"dockerComposeFile": ["../docker-compose.yml", "../docker-compose.build.yml"],
"service": "dev",
"workspaceFolder": "/workspace"

devcontainer 配置明确包含了构建文件，因此当您使用”在容器中重新打开”或”重新构建容器”时，VS Code 可以在本地构建镜像。

扩展

扩展会自动安装在容器内：

扩展	描述
Python	Python 语言支持
ESLint	JavaScript/TypeScript 代码检查
Prettier	代码格式化
Docker	Dockerfile 和 compose 支持
Terraform	HCL 语言支持
Go	Go 语言支持
Rust Analyzer	Rust 语言支持
YAML	YAML 语言支持
Kubernetes	Kubernetes 清单支持

要添加扩展，请编辑 .devcontainer/devcontainer.json 中的 customizations.vscode.extensions 数组。

端口转发

VS Code 会自动转发 compose 文件中定义的端口。noVNC 显示界面可通过 http://localhost:6080/vnc.html 访问 — VS Code 会在端口就绪时通知您。

可以通过 VS Code 中的 Ports 面板按需转发其他端口。

Devcontainer CLI 替代方案

如果您更喜欢命令行而非 VS Code UI：

npm install -g @devcontainers/cli

devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . zsh

重新构建

更改 Dockerfile 或 compose 文件后：

Dev Containers: Rebuild Container

这将重新构建镜像并重启容器。命名卷（workspace、home）在重新构建后会保留。