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