🔹 安装 Poetry
Windows 安装方式
pip install poetry
Linux/macOS 安装方式
# 更新系统套件
sudo apt update && sudo apt upgrade -y
# 安装 Poetry
sudo apt install python3-poetry -y
确认 Poetry 是否安装成功
poetry --version
🔹 建立 Poetry 虚拟环境
设定 Poetry 让虚拟环境建立在专案目录中
poetry config virtualenvs.in-project true
初始化 Poetry 虚拟环境
poetry init
执行后将进入互动式设定：
This command will guide you through creating your pyproject.toml config.
Package name [my-project]:
Version [0.1.0]:
Description []:
Author [Your Name <your_email@example.com>, n to skip]:
License []:
Compatible Python versions [^3.10]:
Would you like to define your main dependencies interactively? (yes/no) [yes]
输入专案名称、版本、相容的 Python 版本后，Poetry 会自动建立 pyproject.toml 档案。
检查虚拟环境资讯
poetry env info
输出范例：
Virtualenv
Python: 3.10.12
Implementation: CPython
Path: /home/ubuntu/my-project/.venv
Executable: /home/ubuntu/my-project/.venv/bin/python
若未显示虚拟环境路径，可手动建立：
poetry env use python3
成功建立后，会显示虚拟环境的路径。
🔹 启动与设定 Python 虚拟环境
启动虚拟环境
source .venv/bin/activate
安装专案套件
poetry install
如果只想安装相依套件（不包含当前专案），可执行：
poetry install --no-root
🔹 在 VSCode 中设定 Python 解析器
1️⃣ 按下 Ctrl + Shift + P 开启命令面板，选择 Python: Select Interpreter。2️⃣ 选择工作区层级的 Python 解析器。3️⃣ 选择 Poetry 虚拟环境的 Python 执行档：
/path/to/project/.venv/bin/python
🔹 启动开发伺服器（Django 范例）
启动伺服器
python3 manage.py runserver
允许外部连线
python3 manage.py runserver 0.0.0.0:8000
🔹 移除与重建虚拟环境
移除虚拟环境
poetry env remove python
移除专案设定并重新初始化
rm pyproject.toml poetry.lock
poetry init
🔹 参考文件
Python 官方文件VSCode Python 扩展文件