在GitHub Codespaces中通过Devcontainer创建Python虚拟环境失败

我在做数据科学项目，仓库里配置了.devcontainer目录（包含devcontainer.json和Dockerfile），想让GitHub Codespaces初始化时自动创建Python虚拟环境，打开终端就能用它运行Jupyter Notebook。但重建Codespaces后找不到虚拟环境，试过多种配置和解释器路径都没解决。

问题根源 #

1. Dockerfile的RUN命令里，两个su vscode -c命令之间没有用&&连接，导致第二个pip安装命令和虚拟环境创建步骤逻辑断裂，没有正确关联执行。
2. 未配置shell自动激活虚拟环境，终端打开后不会自动进入虚拟环境上下文。

修复方案 #

1. 修正Dockerfile

修复命令语法错误，同时添加shell自动激活配置：

ARG VARIANT="3.11"
FROM mcr.microsoft.com/vscode/devcontainers/python:${VARIANT}

# 定义虚拟环境路径
ARG VENV_PATH="/home/vscode/venv"

COPY requirements.txt /tmp/pip-tmp/
# 用&&连接命令确保执行顺序，同时给bashrc添加自动激活命令
RUN su vscode -c "python -m venv ${VENV_PATH}" && \
    su vscode -c "${VENV_PATH}/bin/pip --disable-pip-version-check --no-cache-dir install -r /tmp/pip-tmp/requirements.txt" && \
    echo "source ${VENV_PATH}/bin/activate" >> /home/vscode/.bashrc && \
    rm -rf /tmp/pip-tmp

2. 优化devcontainer.json

确保默认解释器路径正确，同时配置Jupyter关联虚拟环境：

{
    "name": "Python 3",
    "build": {
        "dockerfile": "Dockerfile",
        "context": "..",
        "args": {
            "VARIANT": "3.11",
            "NODE_VERSION": "none"
        }
    },
    "customizations": {
        "vscode": {
            "settings": {
                "python.defaultInterpreterPath": "/home/vscode/venv/bin/python",
                "python.pythonPath": "/home/vscode/venv/bin/python",
                "jupyter.defaultKernelPath": "/home/vscode/venv/bin/python"
            },
            "extensions": [
                "ms-python.python",
                "ms-python.vscode-pylance",
                "GitHub.copilot",
                "ms-toolsai.jupyter"
            ]
        }
    },
    "remoteUser": "vscode",
    "features": {
        "azure-cli": "latest"
    }
}

验证方法 #

重建GitHub Codespaces后：

• 打开终端，查看命令行前缀是否带有(venv)标识
• 执行which python，输出应为/home/vscode/venv/bin/python
• 打开Jupyter Notebook，检查内核是否默认选中该虚拟环境的Python解释器

内容的提问来源于stack exchange，提问作者Rudy Brown