poetry install 失败通常因缺少 poetry.lock 文件;需先运行 poetry lock 或 poetry add 触发生成,且 poetry.lock 必须提交到 Git;poetry init 仅生成 pyproject.toml,不创建环境或锁文件;开发依赖须用 poetry add --group dev 添加;Windows 上 poetry shell 失败多因 PowerShell 执行策略限制。
poetry install 失败时先看
是否存在
很多第一次用
的人卡在
报错,根本原因是项目里没有
文件——它不是手动创建的,而是由
生成的。没运行过
或者删了
,
就会直接失败,报类似
的错误。
实操建议:
立即学习
“
Python免费学习笔记(深入)
”;
新项目初始化后,先执行
(或任意包),它会自动触发
如果已有
但没
,手动跑一次
再
别把
加进
——它和
一样,必须提交,否则别人拉代码后环境不一致
poetry init 不等于项目就 ready 了
只是交互式生成
的骨架,它不会创建虚拟环境,也不安装任何依赖,更不会写入
。很多人以为按完回车就完事了,结果
直接报
。
实操建议:
立即学习
“
Python免费学习笔记(深入)
”;
后必须至少加一个依赖,比如
,才能真正激活锁文件和虚拟环境
检查虚拟环境是否就绪:运行
,看到
字段有实际路径才算成功
如果
报
,说明还没触发环境创建,补一个
或
即可
poetry add --group dev 和 dev-dependencies 的写法差异
开发依赖不能只靠改
手动加字段,那样
不会更新,
也不会装进去。必须用命令明确指定分组,否则
这类工具可能只在本地有、CI 环境里缺失。
Python 3.14.3
微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
实操建议:
立即学习
“
Python免费学习笔记(深入)
”;
添加开发依赖:用
(Poetry 1.2+)或旧版的
验证是否生效:查看
中是否出现
区块,且
里对应包出现在
的条目下
安装时区分场景:
默认装全部(含 dev),而 CI 中常用
来跳过测试工具
Windows 上 poetry shell 启动失败常见于 PowerShell 执行策略
在 Windows 上运行
报
错误,不是 Poetry 本身的问题,而是 PowerShell 默认禁止运行本地脚本。这不是权限问题,也不是杀毒软件拦截,纯粹是系统策略限制。
实操建议:
立即学习
“
Python免费学习笔记(深入)
”;
临时解决:在当前 PowerShell 窗口运行
别用
权限去改机器级策略,没必要,也容易引发其他工具冲突
替代方案:不用
,改用
,完全绕过 shell 激活环节
虚拟环境路径、Python 版本约束、多源镜像配置这些点,得看具体里和怎么写,不是命令一跑就自动适配的。
poetry.lockpoetrypoetry installpoetry.lockpoetry lockpoetry lockpoetry.lockpoetry installUnable to find lock filepoetry add requestspoetry lockpyproject.tomlpoetry.lockpoetry lockpoetry installpoetry.lock.gitignorepackage-lock.jsonpoetry initpyproject.tomlpoetry.lockpoetry run python main.pyModuleNotFoundErrorpoetry initpoetry add clickpoetry env infoPathpoetry env infoNo environment has been createdpoetry addpoetry installpyproject.tomlpoetry.lockpoetry installpytestpoetry add pytest --group devpoetry add pytest -G devpyproject.toml[tool.poetry.group.dev.dependencies]poetry.lockdevelop = truepoetry installpoetry install --without devpoetry shellexecution policySet-ExecutionPolicy RemoteSigned -Scope CurrentUserAdministratorpoetry shellpoetry run python script.pypyproject.toml[[tool.poetry.source]]requires-python