【Python】配置 PYTHONPATH 环境变量_pythonpath环境变量怎么设置-优快云博客

关于设置和使用 PyCharm 以及在 Linux 中配置 PYTHONPATH 环境变量。

配置 PYTHONPATH

PyCharm

运行/调试配置:

在 PyCharm 中，打开 “Run/Debug Configurations” 对话框。
选择要运行的脚本配置。
在 “Environment variables” 字段中，输入 PYTHONPATH 变量和希望添加到 Python 模块搜索路径的目录。

PYTHONPATH=/path/one:/path/two:/path/three

注意事项:

不要在路径中使用引号。即使路径中包含空格，也不需要引号。
在 Linux 和 UNIX-like 系统中，使用冒号 : 分隔不同的路径。例如：/path/one:/path/two。
确保没有打错字，路径是准确无误的。

更改后的操作:

修改环境变量后，通常需要重启 PyCharm 或至少重启 PyCharm 中的 Python 控制台。

手动添加到 sys.path:

如果环境变量的更改没有如预期般工作，可以在脚本的开始处手动添加路径到 sys.path。

import sys

# 添加多个路径到 sys.path
sys.path.append('/path/one')
sys.path.append('/path/two')
sys.path.append('/path/three')

# 一次性添加多个路径到 sys.path
sys.path.extend(['/path/one', '/path/two', '/path/three'])

Linux

临时设置:

在命令行中使用 export 命令来设置一个会话级别的变量，例如以下2种情况：
- 追加新路径: 如果想保留原有的 PYTHONPATH 并追加新的路径，应该这样做：

export PYTHONPATH=$PYTHONPATH:/new/path/one:/new/path/two

这会将 /new/path/one:/new/path/two 追加到现有的 PYTHONPATH 中。如果 PYTHONPATH 原本未设置，它会以新路径作为其值。

设置新路径: 如果想设置一个全新的 PYTHONPATH 而不保留原有的值，可以直接设置：

export PYTHONPATH=/new/path/one:/new/path/two

即设置一个全新的 PYTHONPATH，覆盖原有的环境变量值。

永久设置:

在用户的 home 目录下编辑 .bashrc 或 .bash_profile 文件，添加上述 export 命令。
执行 source ~/.bashrc 或重新登录会话来应用更改。

# 打开 .bashrc 或 .bash_profile
vim ~/.bashrc

# 添加 export 命令
export PYTHONPATH=$PYTHONPATH:/new/path/one:/new/path/two

# 保存并关闭文件

# 重新加载配置文件以应用更改
source ~/.bashrc

注意事项:

路径之间不要有空格。
路径应当是存在的，且用户有适当的读取权限。
不要在路径字符串中包含引号。

注意事项

确保路径正确:
- 验证添加到 PYTHONPATH 中的每个路径确实存在并且包含所需的 Python 包。
避免冲突:
- 确保 PYTHONPATH 不包含与系统路径或其他环境变量冲突的目录。
使用 init.py:
- 确保希望作为包导入的每个目录都包含一个 init.py 文件。
检查远程路径:
- 当使用 PyCharm 的远程解释器时，确保远程机器上的路径与设置的 PYTHONPATH 相匹配。
调试问题:
- 使用 print(sys.path) 在脚本中打印当前的模块搜索路径，以帮助调试路径问题。

扩展 - 写法和使用场景

关于在 UNIX 和 Linux 系统中设置环境变量 PATH 和 PYTHONPATH 的笔记，包括不同的写法和使用场景：

追加新路径到现有变量

不使用花括号和双引号:

export PATH=$PATH:/new/path

使用花括号:

export PATH=${PATH}:/new/path

使用双引号（适用于路径中包含空格或特殊字符）:

export PATH="$PATH:/new/path with spaces"

使用花括号和双引号:

export PATH="${PATH}:/new/path"

只使用双引号，追加路径:

export PATH=$PATH:"/new/path"

将新路径放在现有变量之前

不使用花括号和双引号:

export PATH=/new/path:$PATH

使用花括号:

export PATH=/new/path:${PATH}

只使用双引号，前置路径:

export PATH="/new/path:$PATH"

设置全新的变量值

不使用花括号和双引号:

export PATH=/new/path

使用双引号（适用于路径中包含空格或特殊字符）:

export PATH="/new/path with spaces"

对 PYTHONPATH 的特殊注意

同 PATH 的设置方法一样，PYTHONPATH 也可以通过以上的任一方法来设置。
通常用于指定 Python 解释器搜索 Python 模块的额外目录。

示例汇总

追加单个路径:

export PYTHONPATH=$PYTHONPATH:/new/python/path

追加多个路径:

export PYTHONPATH=$PYTHONPATH:/new/python/path/one:/new/python/path/two

前置路径:

export PYTHONPATH=/new/python/path:$PYTHONPATH

设置新的值:

export PYTHONPATH=/new/python/path

在 .bashrc 或 .bash_profile 中设置这些变量，使它们在每次新的会话开始时自动生效。如需立即应用更改，不重启会话，请使用 source ~/.bashrc 或 . ~/.bashrc 命令。在使用 export 命令时，选择合适的方法取决于是否需要保留已有的路径以及新添加的路径的优先级。