Poetry已安装却提示command not found 重启后终端无法识别怎么办

数据老陈

2026-9-26

修复WSL Ubuntu中Poetry重启后命令找不到的问题

根本原因

Poetry默认安装在用户私有目录下，该路径未被永久添加到Bash的PATH环境变量中，因此重启终端/WSL后系统无法定位到Poetry的执行文件。

第一步：确认Poetry安装路径
执行以下命令查询Poetry的实际安装位置：
```
find $HOME -name "poetry" -type f -executable
```
正常返回结果示例：/home/me/.local/bin/poetry 或 /home/me/.poetry/bin/poetry，记录返回路径中/poetry前面的父目录路径，比如$HOME/.local/bin或$HOME/.poetry/bin。
第二步：写入环境变量到Bash配置文件
执行命令编辑Bash的永久配置文件：
```
nano ~/.bashrc
```
拉到文件最末尾，新增一行内容，将<你记录的父目录路径>替换为上一步拿到的路径：
```
export PATH="<你记录的父目录路径>:$PATH"
```
按Ctrl+O，回车确认保存，再按Ctrl+X退出编辑器。
第三步：使配置立即生效
执行命令加载新的配置：
```
source ~/.bashrc
```
第四步：验证配置
执行poetry --version，如果正常输出版本号即配置完成，后续重启设备/WSL/VS Code终端都不会再出现命令找不到的问题。