使用uv包管理器管理多组件项目的配置与环境问题咨询

默认情况下，uv的workspace会将所有子项目的依赖安装到根目录的虚拟环境中，但要实现每个子项目独立的.venv，需要调整配置并针对性执行命令，以下是具体方案：

一、调整pyproject.toml配置 #

1. 根目录myapp/pyproject.toml #

保留workspace成员声明，无需强制共享环境，配置如下：

[project]
name = "myapp"
version = "0.1.0"

[workspace]
members = [
    "crawler",
    "api",
    "data",
]

2. data/pyproject.toml（子项目依赖定义） #

正常声明自身第三方依赖即可，示例：

[project]
name = "data"
version = "0.1.0"
dependencies = [
    # 填写data需要的第三方依赖，比如"sqlalchemy>=2.0"
]

3. crawler/pyproject.toml和api/pyproject.toml（依赖workspace内的data） #

声明依赖来自workspace，确保开发时使用本地data子项目代码，以crawler为例：

[project]
name = "crawler"
version = "0.1.0"
dependencies = [
    "data @ workspace",
    # 填写crawler需要的其他第三方依赖，比如"requests>=2.31"
]

[tool.uv]
# 允许从workspace安装本地项目
resolution-strictness = "loose"

二、创建并管理各子项目的独立虚拟环境 #

1. 为单个子项目创建独立.venv #

进入子项目目录执行命令：

# 进入crawler目录
cd crawler
# 创建本地虚拟环境
uv venv
# 激活虚拟环境（Windows系统执行 crawler\.venv\Scripts\activate）
source .venv/bin/activate
# 安装依赖（包含workspace内的data）
uv install

若不想切换目录，可通过--project参数指定子项目路径：

# 在myapp根目录为crawler创建虚拟环境
uv venv --project crawler crawler/.venv
# 激活环境后安装依赖
source crawler/.venv/bin/activate
uv install --project crawler

2. 日常开发命令示例 #

• 运行crawler代码：

cd crawler
source .venv/bin/activate
python main.py

• 更新data依赖后同步到crawler：

cd crawler
source .venv/bin/activate
uv update data

三、关键注意事项 #

• 不要在根目录执行uv install或uv venv，否则会生成根目录.venv，干扰子项目独立环境。
• 子项目依赖data时必须使用"data @ workspace"，确保uv使用本地data子项目代码，而非从PyPI拉取。
• 每个子项目的.venv仅包含自身及依赖包，互相隔离，适配不同子项目依赖版本差异的场景。

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