mirror of
https://github.com/whyour/qinglong.git
synced 2026-06-28 02:45:08 +08:00
## 背景 原方案使用系统 Python + pip --prefix 安装依赖到 data/dep_cache/python3, 系统 Python 环境被污染,且无法隔离不同项目的依赖。 ## 改动内容 ### 核心:Python venv 支持 - shell/start.sh: 使用 python3 -m venv 创建虚拟环境,替代 --prefix 模式 - 从 .env 文件读取 PYTHON_VENV_DIR 配置 - 首次启动自动创建 .venv,已存在则跳过 - 仅将 .venv/bin 加入 PATH 优先级,不设置 PYTHONHOME/PYTHONPATH(避免破坏 venv 机制) - .env 不再强制覆盖,仅首次从 .env.example 复制 - 启动时自动修复 task/ql 软链接指向当前部署目录 ### 后端适配 - back/config/const.ts: 新增 PYTHON_VENV_DIR 常量 - back/config/util.ts: venv 模式下跳过 pip --prefix,直接使用 venv 的 pip3 ### 开发模式支持 - shell/dev-env.sh: pnpm start 时自动 source,将 .venv/bin 加入 PATH - package.json: start:back 加入 source dev-env.sh ### 新增文件 - shell/start-simplify.sh: 精简版启动脚本(跳过系统依赖安装,适用于已预装环境的服务器) - README-NODE.md: Node.js 原生部署完整文档 ### 配置 - .env.example: 新增 PYTHON_VENV_DIR=./.venv 配置项(默认注释状态) ## 兼容性 - Docker 模式不受影响(使用独立的 docker-entrypoint.sh,走原有 --prefix 逻辑) - 未配置 PYTHON_VENV_DIR 时默认使用系统 Python(向后兼容)
13 lines
457 B
Bash
Executable File
13 lines
457 B
Bash
Executable File
#!/usr/bin/env bash
|
||
# 开发模式下设置 Python venv 环境变量
|
||
# 用法: source shell/dev-env.sh(需在项目根目录执行)
|
||
|
||
export PYTHON_VENV_DIR="${PYTHON_VENV_DIR:-${PWD}/.venv}"
|
||
|
||
if [[ -f "${PYTHON_VENV_DIR}/bin/python3" ]]; then
|
||
# 仅将 venv 的 bin 加入 PATH,Python 的 venv 机制自动处理包路径
|
||
export PATH="${PYTHON_VENV_DIR}/bin:${PATH}"
|
||
export PIP_CACHE_DIR="${PYTHON_VENV_DIR}/pip"
|
||
mkdir -p "${PIP_CACHE_DIR}"
|
||
fi
|