如何将PYTHONPATH添加至.bashrc文件？配置失效问题求助

一、将PYTHONPATH添加到.bashrc文件的步骤 #

操作起来很简单，跟着下面的步骤走就行：

• 打开终端，用文本编辑器（比如nano或vim）打开.bashrc文件：

  nano ~/.bashrc
  

• 在文件末尾添加你的PYTHONPATH导出命令，比如你提到的这条：

  export PYTHONPATH=${PYTHONPATH}:/Users/jan/miniconda3/lib/python3.7/site-packages/
  

• 保存并退出编辑器（nano按Ctrl+O保存，Ctrl+X退出；vim输入:wq后回车）
• 让修改立即生效，无需重启终端，执行：

  source ~/.bashrc
  

• 验证配置是否成功，执行以下命令查看PYTHONPATH的值：

  echo $PYTHONPATH
  

  如果能看到你添加的路径，就说明配置没问题了。

二、添加到.bashrc后失效的常见原因及解决办法 #

你说终端直接执行命令有效，但写入.bashrc就失效，大概率是下面这些情况之一，逐个排查就能解决：

1. 未重新加载.bashrc文件 #

很多人修改完.bashrc就直接继续用当前终端，但.bashrc只有在终端启动时才会自动加载，修改后必须手动执行source ~/.bashrc才能让当前终端生效；如果是新开终端，一般会自动加载，但图形界面的终端偶尔需要重启程序才能生效。

2. 你实际使用的不是bash shell #

现在不少Linux发行版和macOS默认用zsh而非bash，这种情况下.bashrc不会被加载，你的配置自然失效。先确认当前使用的shell：

echo $SHELL

如果输出是/bin/zsh，那你应该把配置写到~/.zshrc文件里，步骤和上面一致，添加后执行source ~/.zshrc即可生效。

3. PYTHONPATH被后续脚本覆盖了 #

检查一下.bashrc文件中，你添加的export命令之后有没有其他修改PYTHONPATH的语句——比如conda环境初始化脚本、其他自定义export命令，都可能覆盖你之前设置的路径。可以把你的export命令移到.bashrc的最末尾，保证它最后执行，避免被后续命令覆盖。

4. 路径拼写错误或不存在 #

仔细核对你添加的路径/Users/jan/miniconda3/lib/python3.7/site-packages/是否正确，有没有拼写错误，或者这个路径是否真实存在。用ls命令验证：

ls /Users/jan/miniconda3/lib/python3.7/site-packages/

如果提示“No such file or directory”，说明路径有误——可能你的conda环境路径不是这个，或者Python版本不是3.7，修正路径后再重新配置即可。

5. 终端是登录shell而非非登录shell #

bash作为登录shell时，会优先加载~/.bash_profile而非~/.bashrc。这种情况下，你可以把配置写到~/.bash_profile里，或者在~/.bash_profile中添加一行加载.bashrc的命令：

if [ -f ~/.bashrc ]; then
    source ~/.bashrc
fi

这样不管是登录还是非登录shell，都会加载你的.bashrc配置。

内容的提问来源于stack exchange，提问作者user2806363