返回

解决 Poetry 安装后出现的 `poetry: command not found` 错误

windows

Poetry 安装后出现 poetry: command not found 错误？不必担心！

问题

安装 Poetry 后，在重启计算机后，终端中出现 poetry: command not found 错误，这可能让您感到沮丧。别担心，此问题很容易解决！

解决方法

1. 添加 Poetry 到路径环境变量

要使 Poetry 命令可用，您需要将其添加到路径环境变量中。这告诉操作系统在哪个目录中查找可执行文件。

  • 打开终端并输入以下命令：
echo $PATH
  • 检查输出中是否包含 Poetry 的 bin 目录。例如，对于 Windows 用户，路径可能是：
/c/Users/username/.poetry/bin
  • 如果没有包含 Poetry 的 bin 目录，请使用以下命令添加它：
export PATH=$PATH:/c/Users/username/.poetry/bin
  • 对于 Windows 用户，使用分号 (;) 代替冒号 (:)：
setx PATH "%PATH%;/c/Users/username/.poetry/bin"

2. 更新 Bash 配置文件

Bash 配置文件存储了 Bash shell 启动时的设置。我们需要将路径添加到这个文件中，以使 Poetry 命令始终可用。

  • 打开 Bash 配置文件（通常是 ~/.bashrc 或 ~/.bash_profile）。
  • 在文件的末尾添加以下行：
export PATH=$PATH:/c/Users/username/.poetry/bin
  • 保存并关闭文件。
  • 重新启动终端或运行 source ~/.bashrc。

3. 安装 Poetry 的 Shell Completions

Shell completions 是一种方便的功能，可帮助您自动完成 Poetry 命令。让我们安装它：

poetry self install

4. 其他注意事项

  • 确保 Poetry 已全局安装，而不是在虚拟环境中安装。
  • 如果您仍然遇到问题，请尝试卸载并重新安装 Poetry。

结论

通过遵循这些步骤，您应该能够解决 poetry: command not found 错误。如果您仍然遇到问题，请随时在评论中提问！

常见问题解答

  1. 为什么重启后 Poetry 命令不可用？

    • 重启计算机后，环境变量会重置，因此我们需要将 Poetry 的 bin 目录永久添加到路径中。

  2. 我应该将路径添加到哪个配置文件？

    • 对于 Bash 用户，配置文件通常是 ~/.bashrc 或 ~/.bash_profile。对于 Windows 用户，您可以使用系统范围内的配置文件，例如 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment。

  3. Shell completions 有什么用？

    • Shell completions 允许您在键入命令时自动完成 Poetry 命令的名称和参数。

  4. 如果我卸载并重新安装 Poetry，会发生什么？

    • 卸载并重新安装 Poetry 将删除 Poetry 的所有文件，包括 bin 目录。重新安装后，您需要再次将 Poetry 的 bin 目录添加到路径中。

  5. 我可以用其他方法解决此问题吗？

    • 您可以使用符号链接将 Poetry 的 bin 目录链接到 /usr/local/bin 目录。但是，此方法可能因操作系统而异。