安装git-graph后命令无法识别及PDF生成失败问题求助

1. 修复PATH环境变量 #

安装时的警告已经明确指出/home/hemanth/.local/bin不在系统PATH中，这是命令找不到的核心原因：

• 临时生效（仅当前终端会话）：执行以下命令

  export PATH="$HOME/.local/bin:$PATH"
  

  执行后直接测试git-graph --version或git graph是否正常运行。
• 永久生效（所有终端会话）：编辑你的shell配置文件（如~/.bashrc或~/.zshrc，取决于使用的shell），在文件末尾添加一行：

  export PATH="$HOME/.local/bin:$PATH"
  

  保存后执行source ~/.bashrc（bash环境）或source ~/.zshrc（zsh环境）让配置立即生效。

2. 验证git-graph安装状态 #

PATH修复后，执行以下命令确认安装是否正常：

pip show git-graph

若输出包含git-graph的版本、安装路径等信息，说明安装有效；若没有输出，重新执行安装命令：

pip install git-graph

3. 解决PDF生成失败问题 #

之前出现过显示提交文本但未生成PDF的情况，大概率是Graphviz的dot命令未正确配置：

• 确认Graphviz已安装：执行dot -V，若提示命令找不到，根据系统重新安装Graphviz（如Ubuntu用sudo apt install graphviz，CentOS用sudo yum install graphviz）。
• 确保dot命令在PATH中：若安装后仍找不到，检查dot的安装路径（通常为/usr/bin/dot），确认该路径已在系统PATH内。

4. 测试功能 #

进入你的Git仓库目录，执行以下命令测试PDF生成：

git graph --pdf output.pdf

若成功生成output.pdf文件，说明问题已解决。

内容的提问来源于stack exchange，提问作者PUNETI HEMANTH KUMAR REDDY