sudo切换用户执行Python脚本时PYTHONPATH异常致同目录模块无法导入

云上老周

2026-5-26

解决sudo切换用户后Python模块导入失败的问题

首先得指出你脚本里的一个小语法问题：你写的cd $1 sudo -u userX PYTHONPATH=. python3 $2是错误的——cd命令和sudo命令在同一行没有分隔符，导致cd会尝试把$1和sudo当作两个目录参数，根本不会执行后面的sudo命令！这是第一个要修正的点。

接下来，即使你修正了语法，用cd $1; sudo ...这样的写法，还是可能遇到PYTHONPATH的问题，原因主要有两个：

sudo默认会重置环境变量：sudo出于安全考虑，会清除大部分当前用户的环境变量，重新设置一个干净的环境。你在sudo命令前设置的PYTHONPATH可能不会被传递给userX的环境，或者即使你写在sudo同一行，PYTHONPATH=.里的.是当前用户的工作目录，但切换到userX后，这个路径的上下文可能有变化（比如userX的默认目录不同）。
权限问题：如果userX没有权限访问你切换到的$1目录，即使路径设置对了，也无法读取里面的模块文件。

给你几个可行的解决方案：

方案1：修正脚本语法，使用绝对路径设置PYTHONPATH

把脚本改成这样，确保cd执行成功后再运行sudo，并且用绝对路径设置PYTHONPATH：

# 先切换到目标目录，确保命令执行成功才继续
cd "$1" && sudo -u userX PYTHONPATH="$(pwd)" python3 "$2"

这里用$(pwd)获取当前目录的绝对路径，代替.，避免切换用户后路径上下文的歧义。

如果需要保留当前用户的部分环境变量，可以给sudo加-E选项（注意：这会保留当前用户的环境，有一定安全风险，仅在可信环境使用）：

cd "$1" && sudo -E -u userX PYTHONPATH="$(pwd)" python3 "$2"

不管环境变量如何，直接在你的Python脚本开头添加当前脚本所在目录到sys.path：

import sys
from pathlib import Path

# 获取脚本所在目录的绝对路径并添加到模块搜索路径
script_dir = Path(__file__).parent.resolve()
sys.path.append(str(script_dir))

这种方法不依赖环境变量，不管用什么用户运行，都能正确找到同目录的模块。

最后别忘了检查userX是否有$1目录的读取权限，以及目录下Python文件的读取权限。可以用sudo -u userX ls "$1"测试，如果能列出文件，说明权限没问题；如果报错，需要调整目录或文件的权限。

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