已经安装了ROS环境却还是报错`ModuleNotFoundError: No module named ‘rclpy‘`

rclpy 不是 Python 自带的标准库，也不是通过 pip 全局安装的普通库，它是 ROS2 框架专属的 Python 核心库 ，其可被Python识别的前提是：加载对应 ROS2 版本的环境配置脚本。

重启电脑或者新开一个路径的终端后，终端的环境变量会被重置，ROS2 的环境配置未被加载，导致 Python 解释器无法找到 rclpy 模块的安装路径，从而抛出"模块未找到"错误。

具体衍生出3个常见场景（均会导致该错误）：

该方法适用于"临时运行脚本"，每次新开终端都需要执行一次，核心是运行 ROS2 安装目录下的 setup.bash 脚本。

执行对应版本的环境加载命令：

bash 复制代码

# 通用命令（适配绝大多数默认安装场景，ROS2 humble 版本）
source /opt/ros/humble/setup.bash

若你的 ROS2 版本不是 humble，替换版本名即可：

bash 复制代码

# 示例1：ROS2 foxy 版本
source /opt/ros/foxy/setup.bash
# 示例2：ROS2 galactic 版本
source /opt/ros/galactic/setup.bash

ROS2 的 setup.bash 脚本作用：配置 PYTHONPATH、PATH 等环境变量，告诉系统和 Python 解释器 ROS2 相关库（rclpy、sensor_msgs 等）的安装路径；
若执行命令后提示"没有该文件或目录"，说明 ROS2 未正确安装，或安装路径非默认 /opt/ros/，需重新确认 ROS2 安装目录。

该方法通过修改终端的配置文件，让每次新开终端时，自动加载 ROS2 环境配置脚本，一劳永逸。

确认你的终端类型（Linux 常见两种：bash 或 zsh，可通过 echo $SHELL 查看）：
- 输出 /bin/bash：使用 ~/.bashrc 配置文件；
- 输出 /bin/zsh：使用 ~/.zshrc 配置文件。

编辑对应配置文件（以 bash 为例，最常用）：

bash 复制代码

# 打开 .bashrc 配置文件（使用 gedit 图形化编辑器，方便编辑）
gedit ~/.bashrc
# 若没有 gedit，可使用 vim 编辑器
vim ~/.bashrc

让配置立即生效（或重启终端自动生效）：

bash 复制代码

# 对应 bash 终端
source ~/.bashrc
# 若为 zsh 终端，执行：source ~/.zshrc

若已加载 ROS2 环境，仍提示 rclpy 未找到，大概率是 Python 环境不匹配，常见场景：使用了虚拟环境、系统存在多个 Python 版本。

确认当前终端的 Python 解释器路径（加载 ROS2 环境后执行）：

bash 复制代码

# 查看 Python3 路径（ROS2 仅支持 Python3，不支持 Python2）
which python3
# 查看 Python 版本
python3 --version

确认 ROS2 对应的 Python 版本：ROS2 humble 要求 Python 3.10，foxy 要求 Python 3.8，若你的 Python 版本不匹配，需安装对应版本；
避免使用虚拟环境直接运行 ROS2 脚本（若需使用虚拟环境）：
- 激活虚拟环境后，再执行 source /opt/ros/humble/setup.bash 加载 ROS2 环境；
- 确保虚拟环境中安装了 setuptools 等依赖：pip install setuptools；
直接使用 ROS2 自带的 Python 解释器运行脚本（终极解决，避免版本冲突）：
bash 复制代码
```
# 加载 ROS2 环境后，使用 ros2 对应的 python3 运行脚本
/opt/ros/humble/bin/python3 ros_demo.py
```

加载环境后，执行 echo $PYTHONPATH，若输出中包含 /opt/ros/humble/lib/python3.10/site-packages（对应你的 ROS2 版本和 Python 版本），说明环境变量配置成功；
执行 python3 -c "import rclpy; print('rclpy loaded successfully')"，若输出"rclpy loaded successfully"，说明 rclpy 模块可被正常导入；
直接运行你的 ros_demo.py 脚本，无 ModuleNotFoundError 报错，且能正常启动 ROS2 节点，说明问题完全解决。

问题现象	核心原因	快速解决	永久解决
`ModuleNotFoundError: No module named 'rclpy'`	未加载 ROS2 环境配置，Python 无法找到 `rclpy` 路径	终端执行 `source /opt/ros/humble/setup.bash`	编辑 `~/.bashrc`，末尾添加上述命令并 `source ~/.bashrc`