Python – poetry（3）配置项详解

config 命令

• poetry 通过 config 命令进行配置
• 也可以直接在 config.toml 文件中进行配置，该文件将在首次运行该命令时自动创建

文件目录

• macOS：~/Library/Application Support/pypoetry
• Windows: C:\\Users\\<username>\\AppData\\Roaming\\pypoetry

查看当前配置列表

poetry config --list

目前就这些配置项

查看某个配置项

poetry config virtualenvs.path

修改某个配置项

poetry config virtualenvs.path /path/to/cache/directory/virtualenvs

移除某个配置项

poetry config virtualenvs.path --unset

使用环境变量

• 在使用 CI 工具时，会经常使用环境变量，这样可以不必执行 poetry config 命令
• poetry 支持环境变量，任何设置都可以使用环境变量来设置
• 环境变量必须以poetry_ 作为前缀，大写名称组成，用_下划线代替.和-

栗子：virtualenvs.path

export POETRY_VIRTUALENVS_PATH=/path/to/virtualenvs/directory

配置项详解

cache-dir

poetry 使用的缓存目录的路径

默认目录路径

• macOS: ~/Library/Caches/pypoetry
• Windows: C:\\Users\\<username>\\AppData\\Local\\pypoetry\\Cache
• Unix: ~/.cache/pypoetry

installer.parallel

安装程序时并行执行，默认 true

virtualenvs.create

• 如果虚拟环境不存在，则会自动创建一个新的虚拟环境，默认 true
• 如果设为 false，则私用的 Python 环境必须安装且可使用 pip

virtualenvs.in-project

• 在项目的根目录中创建 virtualenv，默认 null
• 如果设置为 true，将在项目根目录中名为 .venv 的文件夹中创建 virtualenv
• 如果未显式设置（默认），poetry 将使用 .venv 目录中的 virtualenv（如果有）
• 如果设置为 false，poetry 将忽略任何现有的 .venv 目录

virtualenvs.path

在其中创建虚拟环境的目录

默认：{cache-dir}/virtualenvs

像我上面的配置就是：/Users/polo/Library/Caches/pypoetry/virtualenvs