Python开发容器无法创建venv的问题排查求助

1. 解决python3.10-venv找不到的问题 #

Ubuntu 22.04的python3.10-venv包存放在universe仓库中，默认可能未启用，直接安装会出现找不到包的错误。推荐将系统依赖安装步骤移至Dockerfile中完成，比在postCreate阶段操作更稳定，还能规避权限问题：

方案一：修改Dockerfile（推荐） #

在Dockerfile中添加Python依赖安装步骤，放在AWS CLI安装之前：

FROM mcr.microsoft.com/devcontainers/base:ubuntu-22.04

COPY install.sh /tmp/scripts/

# 先安装Python 3.10及venv依赖
RUN apt-get update && apt-get install -y \
    python3.10 \
    python3.10-venv \
    python3-pip \
    && rm -rf /var/lib/apt/lists/*

RUN sh /tmp/scripts/install.sh 

CMD ["tail", "-f", "/dev/null"]

install.sh保持原有内容即可，无需修改。

方案二：修改postcreate.sh（仅当必须在postCreate阶段安装时使用） #

在postcreate.sh中先启用universe仓库再更新源：

#!/bin/bash

add_to_bashrc() {
    echo "$1" >> /home/vscode/.bashrc
}

# 启用universe仓库并更新软件源
sudo add-apt-repository universe -y
sudo apt-get update -y
# 安装python3.10-venv
sudo apt install python3.10-venv -y

add_to_bashrc 'alias python="python3"'

source /home/vscode/.bashrc

2. 解决src目录venv的权限问题 #

因要求使用src级别的venv，直接在postcreate.sh末尾添加创建步骤，注意以vscode用户身份操作（不要用sudo，否则会导致venv权限异常）：

# 切换到src目录创建venv（替换为你的实际仓库名称）
cd /workspaces/你的仓库名/src
python3 -m venv venv
# 可选：将venv自动激活命令加入bashrc，避免每次手动激活
add_to_bashrc 'source /workspaces/你的仓库名/src/venv/bin/activate'

3. 清理冗余操作 #

原postcreate.sh中重复执行了sudo apt-get update和sudo apt update，这两个命令功能完全一致，保留其中一个即可，减少不必要的耗时。

验证配置 #

修改完成后重新构建容器：

• 删除旧的容器和镜像
• 重新打开DevContainer
• 进入容器后检查src目录下的venv：ls /workspaces/你的仓库名/src/venv
• 测试激活venv：source /workspaces/你的仓库名/src/venv/bin/activate，确认命令行前缀出现(venv)

内容的提问来源于stack exchange，提问作者Phil Gunning