如何将Docker中创建的Python venv连接至VSCode并使用

一、先优化你的Dockerfile #

当前Dockerfile中，venv的激活仅在构建阶段生效，容器运行时默认仍使用系统Python。可通过两种方式调整：

方式1：设置环境变量指向venv的Python #

修改Dockerfile，添加环境变量让系统默认路径优先使用venv内的Python：

# Usa una imagen base de Python
FROM python:3.8

# Establece el directorio de trabajo
WORKDIR /app

# Copia el archivo requirements.txt al contenedor
COPY requirements.txt .

# Instala las dependencias en el entorno virtual
RUN python -m venv venv
RUN /bin/bash -c "source venv/bin/activate && pip install -r requirements.txt"

# 设置环境变量，让venv的Python成为默认
ENV PATH="/app/venv/bin:$PATH"

# Expone el puerto si es necesario
# EXPOSE 8000

# Inicia la aplicación（现在调用的是venv内的python）
CMD ["python", "app.py"]

方式2：用entrypoint脚本自动激活venv #

若不想修改系统PATH，可创建entrypoint脚本实现自动激活：

1. 本地新建entrypoint.sh文件：

#!/bin/bash
source /app/venv/bin/activate
exec "$@"

2. 修改Dockerfile引入该脚本：

# ... 保留之前的构建步骤 ...

# 复制entrypoint脚本到容器并赋予执行权限
COPY entrypoint.sh .
RUN chmod +x entrypoint.sh

# 设置entrypoint，确保容器启动时先激活venv
ENTRYPOINT ["/app/entrypoint.sh"]

# CMD命令将在venv激活后执行
CMD ["python", "app.py"]

二、VSCode远程连接容器后指定venv解释器 #

1. 用VSCode Docker扩展启动容器，通过「远程资源管理器」连接到运行中的容器。
2. 打开容器内的/app目录，按下Ctrl+Shift+P（Mac为Cmd+Shift+P），输入Python: Select Interpreter。
3. 在弹出的列表中选择/app/venv/bin/python，VSCode会将此venv设为默认解释器。

三、配置VSCode终端自动激活venv #

若希望打开终端时自动激活venv，在容器内的.vscode/settings.json中添加以下配置：

{
    "python.defaultInterpreterPath": "/app/venv/bin/python",
    "terminal.integrated.profiles.linux": {
        "bash": {
            "path": "bash",
            "args": ["-c", "source /app/venv/bin/activate && exec bash"]
        }
    },
    "terminal.integrated.defaultProfile.linux": "bash"
}

四、测试运行脚本 #

1. 在容器内的/app目录创建测试脚本test.py：

import requests  # 假设requirements.txt中包含该依赖
print("Venv测试成功，requests版本：", requests.__version__)

2. 右键脚本选择「Run Python File in Terminal」，或在终端直接执行：

python test.py

此时将自动使用venv内的Python和依赖库，效果与本地venv完全一致。

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