alexeye/devtools-polyglot

多语言开发容器（Polyglot Dev Container）

https://img.shields.io/docker/pulls/alexeye/devtools-polyglot](https://hub.docker.com/r/alexeye/devtools-polyglot) https://img.shields.io/docker/image-size/alexeye/devtools-polyglot/latest](https://hub.docker.com/r/alexeye/devtools-polyglot) https://github.com/alexeye/custom-docker/actions/workflows/devtools-polyglot.yml/badge.svg](https://github.com/alexeye/custom-docker/actions/workflows/devtools-polyglot.yml)

适用于VS Code远程容器的生产就绪多语言开发容器。

针对构建微服务、数据管道和云原生应用（目标平台为Azure、Databricks及容器化环境）的团队优化。

bash
docker pull alexeye/devtools-polyglot:latest

---

为什么选择此镜像？

---

包含的运行时

---

预装工具

Python生态

Go生态

Node.js生态

数据库与云工具

---

快速开始

选项1：最小化配置

在项目中创建.devcontainer/devcontainer.json：

json
{
  "name": "我的项目",
  "image": "alexeye/devtools-polyglot:latest"
}

在VS Code中打开 → "在容器中重新打开" → 完成。

选项2：带持久化的完整配置

json
{
  "name": "我的项目",
  "image": "alexeye/devtools-polyglot:latest",

  "mounts": [
    "source=polyglot-shell-history,target=/home/vscode/.shell_history,type=volume",
    "source=polyglot-databricks-config,target=/home/vscode/.config/databricks,type=volume",
    "source=polyglot-azure-config,target=/home/vscode/.azure,type=volume",
    "source=polyglot-go-cache,target=/home/vscode/go/pkg,type=volume",
    "source=polyglot-npm-cache,target=/home/vscode/.npm,type=volume",
    "source=polyglot-uv-cache,target=/home/vscode/.cache/uv,type=volume"
  ],

  "containerEnv": {
    "DATABRICKS_CONFIG_FILE": "/home/vscode/.config/databricks/databrickscfg"
  },

  "postStartCommand": "uv sync 2>/dev/null || true",
  "remoteUser": "vscode"
}

---

VS Code扩展（预配置21个）

捆绑的devcontainer.json包含以下扩展：

---

持久化（零摩擦体验）

容器重建后保留的内容

VS Code自动处理的功能

---

与Databricks协作

首次设置（永久保留）

bash
databricks configure
# 输入工作区URL和令牌
# 保存到~/.config/databricks/databrickscfg（持久化卷）

使用Databricks连接

python
from databricks.connect import DatabricksSession

spark = DatabricksSession.builder.getOrCreate()
df = spark.sql("SELECT * FROM my_catalog.my_schema.my_table")
df.show()

CI/CD配置（环境变量）

json
{
  "containerEnv": {
    "DATABRICKS_HOST": "${localEnv:DATABRICKS_HOST}",
    "DATABRICKS_TOKEN": "${localEnv:DATABRICKS_TOKEN}"
  }
}

---

与PostgreSQL协作

使用pgmi进行数据库部署

https://github.com/vvka-141/pgmi%E6%98%AFPostgreSQL%E5%8E%9F%E7%94%9F%E9%83%A8%E7%BD%B2%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%85%81%E8%AE%B8%E5%AE%8C%E5%85%A8%E7%94%A8SQL%E7%BC%96%E5%86%99%E9%83%A8%E7%BD%B2%E9%80%BB%E8%BE%91%E3%80%82

bash
# 初始化带脚手架的新项目
pgmi init myapp --template basic

# 部署到数据库（读取pgmi.yaml配置）
pgmi deploy .

# 用显式连接部署
pgmi deploy . --connection "postgresql://user:pass@localhost/mydb"

# 部署到特定数据库
pgmi deploy . --database staging_db

# 覆盖参数
pgmi deploy . --param env=production

项目结构使用deploy.sql存储SQL逻辑，可选pgmi.yaml存储配置。

使用psql客户端

bash
psql -h localhost -U postgres -d mydb

---

与Python协作

使用uv（推荐）

bash
# 创建新项目
uv init my-project && cd my-project

# 添加依赖
uv add fastapi uvicorn sqlalchemy

# 添加开发依赖
uv add --dev pytest ruff mypy

# 运行应用
uv run python -m uvicorn main:app --reload

# 运行测试
uv run pytest

多Python版本

bash
# 列出可用版本
uv python list

# 将项目固定到特定版本
uv python pin 3.10

# 创建带特定版本的虚拟环境
uv venv --python 3.11

---

端口转发

---

镜像详情

---

故障排除

重建容器后Databricks配置丢失

确保配置了卷挂载：

json
"mounts": [
  "source=polyglot-databricks-config,target=/home/vscode/.config/databricks,type=volume"
],
"containerEnv": {
  "DATABRICKS_CONFIG_FILE": "/home/vscode/.config/databricks/databrickscfg"
}

Git凭证不工作

VS Code会自动处理。若问题持续：

bash
# 检查主机上的凭证助手
git config --global credential.helper

# 对于SSH，验证代理是否运行
ssh-add -l

首次启动缓慢

首次拉取需下载约3GB。后续启动因Docker层缓存而加快。

---

从源码构建

bash
git clone https://github.com/alexeye/custom-docker.git
cd custom-docker

# 构建
make polyglot

# 测试
make polyglot-test

# 交互式Shell
make shell IMAGE=devtools/polyglot

---

许可证

Apache-2.0

---

链接

• Docker Hub: https://hub.docker.com/r/alexeye/devtools-polyglot
• 源码: https://github.com/alexeye/custom-docker
• 问题: https://github.com/alexeye/custom-docker/issues

工具参考

• https://github.com/astral-sh/uv
• https://github.com/vvka-141/pgmi
• https://docs.databricks.com/dev-tools/cli/index.html
• https://code.visualstudio.com/docs/devcontainers/containers
• https://marketplace.visualstudio.com/items?itemName=***.claude-code