Webots R2023b 完整安装配置教程

Ne0inhk

— 9 min read

Webots R2023b 完整安装配置教程

声明：本教程由豆包、ChatGPT等AI工具协助完成。

本教程讲解如何安装 Python3、包管理器 Micromamba、必要依赖包（如 opencv-python），以及 Webots 仿真软件，并完成 Micromamba Python 环境与 MATLAB 地址的配置，适用于 Windows、macOS 双系统。

一、前置说明

  1. 适用场景：需要使用 Webots 进行仿真开发，同时依赖 Python 进行脚本编写、OpenCV 进行图像处理，通过 Micromamba 管理 Python 环境，并关联 MATLAB 路径用于联合开发。
  2. 版本约定（兼容性最优）：
  • Python：3.11（Webots R2023b 最优兼容版本，适配性更稳定）
  • Micromamba：最新稳定版
  • OpenCV-Python：4.8.0（避免过高版本与 Webots 冲突）
  • Webots：R2023b（稳定版，支持 Python3.11，适配双系统，兼容ROS2联合仿真）
  • MATLAB：R2022b 及以上（确保与 Python 版本兼容）
注：全程以“管理员身份”操作（Windows）/ 终端无需sudo（macOS），避免权限不足导致安装失败；安装路径建议全英文、无空格，避免中文路径引发的兼容性问题；所有命令行操作需严格按照教程格式执行，避免输入错误；各软件版本需严格遵循约定，避免版本不兼容。

二、Python3 安装（Windows + macOS 通用）

2.1 下载 Python3 安装包

访问 Python 官方下载地址：https://www.python.org/downloads/，根据自身系统选择对应安装包：

  • Windows：选择「Windows Installer (64-bit)」，版本选择 3.11.x（如 3.11.8），避免下载最新测试版。
  • macOS：根据芯片选择（Intel 芯片选「macOS 64-bit installer」，Apple Silicon 芯片选「macOS universal2 installer」），同样选择 3.11.x 版本。

2.2 安装步骤（Windows）

  1. 双击下载的 .exe 安装包，勾选安装界面底部「Add Python 3.11 to PATH」（关键步骤，避免后续无法在终端调用 Python）。
  2. 点击「Customize installation」（自定义安装），取消勾选「Optional Features」中不需要的组件（如 Documentation、tcl/tk and IDLE，新手可全部保留），点击「Next」。
  3. 选择安装路径（建议默认路径，或自定义为「D:\Python311」，全英文无空格），点击「Install」，等待安装完成。
  4. 验证安装：打开「命令提示符」（Win+R 输入 cmd），输入 python --version 或 python3 --version，若显示「Python 3.11.x」，则安装成功。

2.3 安装步骤（macOS）

  1. 双击下载的 .pkg 安装包，按照提示点击「继续」，同意许可协议，选择安装位置（默认即可），输入电脑密码完成安装。
  2. 验证安装：打开「终端」（Launchpad → 其他 → 终端），输入 python3 --version，若显示「Python 3.11.x」，则安装成功。
  3. 补充说明：macOS 自带 Python2.7（已废弃），因此必须使用 python3 命令调用刚安装的 Python3.11，避免混淆。

三、Micromamba 安装与配置（包管理器）

本教程选用 Micromamba 作为包管理工具（轻量、快速），用于创建独立的 Python 环境，避免不同项目的依赖冲突。

注：这只是一种包管理软件，若你习惯使用其他包管理工具（如 conda、miniconda），可参考本教程中 Python 环境创建、依赖包安装的逻辑，采用类似方式进行配置。

3.1 下载与安装 Micromamba

Windows 系统

访问 Micromamba 官方文档：https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html，下滑至「Installation」部分，找到 Windows 安装命令，复制并在「命令提示符」（管理员身份）中执行：

curl-Ls https://micro.mamba.pm/api/micromamba/win-64/latest |tar-xvj bin\micromamba.exe -O> micromamba.exe 
micromamba shell hook -s cmd.exe | Out-String | Invoke-Expression
macOS 系统

其他细节请参考：https://blog.ZEEKLOG.net/knicknock/article/details/155916386

curl-Ls https://micro.mamba.pm/api/micromamba/osx-64/latest |tar-xvj bin/micromamba

初始化 Micromamba（根据终端类型选择命令，默认 zsh 终端）：

./bin/micromamba shell hook -szsh|source

若为 bash 终端，执行：

./bin/micromamba shell hook -sbash|source
可选：配置国内源（加速包下载）

默认源为国外地址，可通过以下命令配置清华镜像源，提升后续包安装速度：

# 创建配置文件目录mkdir-p ~/.mamba # 写入国内源配置echo"channels: - defaults - conda-forge default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud show_channel_urls: true"> ~/.mamba/mambarc

3.2 验证 Micromamba 安装

在终端（cmd/终端）输入以下命令，若显示 Micromamba 的版本号（如 1.5.0），则安装成功：

micromamba --version

3.3 用 Micromamba 创建 Python 环境（核心步骤）

创建一个专门用于 Webots 开发的 Python 环境（命名为 webots-env，可自定义），避免与系统 Python 环境冲突：

执行创建命令（指定 Python 版本为 3.11，与之前安装的 Python 版本一致）：

micromamba create -n webots-env python=3.11-y

说明：-n 后面是环境名（webots-env），-y 表示自动确认安装，无需手动输入 y。

激活环境（环境创建完成后执行）：

Windows：

micromamba activate webots-env

macOS：

./bin/micromamba activate webots-env

（若Micromamba初始化成功，可直接输入micromamba activate webots-env）

备注：后续所有 Python 包（如 opencv-python）都需在该环境下安装，确保依赖统一。

四、必要 Python 包安装（opencv-python 等）

确保已激活 Micromamba 创建的 webots-env 环境（终端显示 (webots-env)），执行以下命令安装所需包，优先使用 conda 安装，避免 pip 安装的包与环境冲突。

4.1 安装 opencv-python

micromamba install opencv-python=4.8.0 -y

说明：指定版本为 4.8.0，避免过高版本（如 4.9.x）与 Webots 兼容性问题；若 conda 安装失败，可使用 pip 安装：

pip install opencv-python==4.8.0

4.2 安装其他必要依赖包

Webots 开发中常用的其他包（根据需求选择安装）：

# 安装 numpy（OpenCV 依赖，处理数值计算） micromamba install numpy -y# 安装 matplotlib（用于绘图、数据可视化） micromamba install matplotlib -y# 安装 pillow（图像处理辅助包） micromamba install pillow -y

4.3 验证包安装

在激活的 webots-env 环境中，输入 python3（macOS）/ python（Windows），进入 Python 交互环境，执行以下命令：

import cv2 import numpy print(cv2.__version__)# 应输出 4.8.0print(numpy.__version__)# 输出任意稳定版本即可

若无报错，说明包安装成功；若报错“ModuleNotFoundError”，则重新激活 webots-env 环境，再次执行对应安装命令。

五、Webots 安装与配置

5.1 下载 Webots 安装包

访问 Webots 官方下载地址（跳转至 GitHub Releases 页面）：https://github.com/cyberbotics/webots/releases，选择对应系统的安装包，版本建议选择 R2023b（稳定版，对 Python3.11 兼容性更优，支持原生 Apple Silicon，适配 ROS2 联合仿真需求）：

  • Windows：下载「Windows 64-bit」安装包（.exe 格式）
  • macOS：下载「macOS」安装包（.dmg 格式）

5.2 安装 Webots（Windows）

  1. 双击下载的 .exe 安装包，选择安装语言（建议中文），点击「下一步」。
  2. 同意许可协议，选择安装路径（建议默认路径，或自定义全英文无空格路径，如「D:\Webots」）。
  3. 勾选「创建桌面快捷方式」，点击「下一步」，等待安装完成，点击「完成」。

5.3 安装 Webots（macOS）

  1. 双击下载的 .dmg 安装包，将「Webots」拖拽到「Applications」（应用程序）文件夹中，完成安装。
  2. 首次打开 Webots 时，可能会提示「无法打开，因为它来自未知开发者」，解决方法：打开「系统设置」→「隐私与安全性」→ 下滑找到「Webots」，点击「仍要打开」，即可正常启动。

5.4 Webots 关联 Micromamba Python 环境（核心配置）

Webots 默认可能无法找到 Micromamba 创建的 Python 环境，需要手动指定 Python 路径，确保 Webots 能调用该环境下的 Python 及安装的包（如 opencv-python）。

步骤 1：找到 Micromamba 环境的 Python 路径

确保已激活 webots-env 环境，在终端输入以下命令，查看 Python 路径：

# macOSwhich python3 # Windows where python

记录输出的路径（关键，后续需用到）：

  • Windows 示例：D:\micromamba\envs\webots-env\python.exe
  • macOS 示例（Intel）：/usr/local/micromamba/envs/webots-env/bin/python3
  • macOS 示例（Apple Silicon）：/opt/homebrew/micromamba/envs/webots-env/bin/python3
步骤 2：Webots 中配置 Python 路径
  1. 打开 Webots 软件，点击顶部菜单栏「工具」→「偏好设置」（Windows）/「Webots」→「偏好设置」（macOS）。
  2. 在弹出的窗口中，找到「Python」选项卡，点击「Python 命令」后的「浏览」，选择步骤 1 中记录的 Python 路径（Windows 选 .exe 文件，macOS 选 python3 文件）。
  3. 点击「确定」，重启 Webots，配置生效。
步骤 3：验证 Webots 与 Python 环境关联成功
  1. 打开 Webots，新建一个简单的仿真场景（如「Empty World」）。
  2. 在场景中添加一个机器人（如「e-puck」），右键机器人 →「添加控制器」→「Python」，创建一个新的 Python 控制器脚本。
  3. 在脚本中输入以下代码，保存并运行仿真：
import cv2 print("OpenCV 版本：", cv2.__version__)print("Python 环境关联成功！")
  1. 若仿真正常运行，且控制台输出 OpenCV 版本（4.8.0），则关联成功；若报错“ModuleNotFoundError: No module named ‘cv2’”，则重新检查 Python 路径配置（确保指向 webots-env 环境的 Python），并确认 opencv-python 已在该环境安装。

六、配置 Micromamba Python 环境与 MATLAB 地址

若需要在 Webots 中调用 MATLAB 相关功能（如 MATLAB 脚本、工具箱），需手动配置 MATLAB 安装地址，确保 Webots 能正常关联 MATLAB。

6.1 找到 MATLAB 安装地址

  • Windows：默认安装路径为 C:\Program Files\MATLAB\R2022b（R2022b 为 MATLAB 版本，根据自身安装版本修改），核心路径为「MATLAB 根目录」。
  • macOS：默认安装路径为/Applications/MATLAB_R2022b.app，核心路径为「/Applications/MATLAB_R2022b.app/」。

6.2 配置 MATLAB 地址

  1. 打开 Webots，点击顶部菜单栏「工具」→「偏好设置」→「MATLAB」选项卡。
  2. 点击「MATLAB 根目录」后的「浏览」，选择上述找到的 MATLAB 安装根目录，点击「确定」，重启 Webots 生效。

七、常见问题排查

问题 1： 终端输入 micromamba 提示「不是内部或外部命令」？

解决：重新执行 Micromamba 初始化命令，或重启终端；若仍失败，手动将 Micromamba 的 bin 目录添加到系统环境变量（PATH）。

问题 2： Webots 运行 Python 脚本报错「ModuleNotFoundError: No module named ‘cv2’」？

解决：确认已激活 webots-env 环境，且 opencv-python 已安装；重新检查 Webots 中配置的 Python 路径，确保路径指向该环境的 Python。

问题 3： macOS 打开 Webots 提示「未知开发者」？

解决：进入「系统设置」→「隐私与安全性」，找到 Webots，点击「仍要打开」；或按住 Control 键，右键点击 Webots，选择「打开」。

Read more

Flutter 三方库 mix_context 的鸿蒙化适配指南 - 实现极简上下文增强、支持非 Widget 作用域下的 BuildContext 访问与状态注入

Flutter 三方库 mix_context 的鸿蒙化适配指南 - 实现极简上下文增强、支持非 Widget 作用域下的 BuildContext 访问与状态注入

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 mix_context 的鸿蒙化适配指南 - 实现极简上下文增强、支持非 Widget 作用域下的 BuildContext 访问与状态注入 前言 在进行 Flutter for OpenHarmony 开发时，我们经常会遇到底层逻辑（如 Service、Repository）需要访问 BuildContext 的窘境（例如为了弹出一个全局 Dialog 或获取当前的主题颜色）。虽然传统的做法是层层传递参数，但代码会因此变得臃肿。mix_context 提供了一种更优雅的上下文混入与注入方案。本文将指导大家如何在鸿蒙端利用该库提升代码的响应能力。 一、原理解析 / 概念介绍 1.1 基础原理 mix_context 的核心思想是将 BuildContext 的引用通过全局代理或单例模式进行“

By Ne0inhk
Flutter 三方库 hooks_runner 的鸿蒙化适配指南 - 实现声明式的生命周期 Hook 任务管理、支持端侧自动化脚本触发与执行流精准编排实战

Flutter 三方库 hooks_runner 的鸿蒙化适配指南 - 实现声明式的生命周期 Hook 任务管理、支持端侧自动化脚本触发与执行流精准编排实战

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 hooks_runner 的鸿蒙化适配指南 - 实现声明式的生命周期 Hook 任务管理、支持端侧自动化脚本触发与执行流精准编排实战 前言 在进行 Flutter for OpenHarmony 的自动化工具、CI/CD 插件或具备高度动态逻辑的业务系统开发时，如何有序、可控地执行一系列相互依赖的“任务钩子（Hooks）”？hooks_runner 是一个专为任务生命周期编排设计的轻量级引擎。它能将离散的函数逻辑拆解并组装成一条健壮的执行流水线。本文将介绍如何在鸿蒙端利用该库构建极致的任务执行闭环。 一、原理解析 / 概念介绍 1.1 基础原理 hooks_runner 采用了“注册-触发（Register & Trigger）”模式。它允许开发者在不同的生命周期阶段（如 pre_

By Ne0inhk
Flutter 三方库 stream_channel 的鸿蒙化适配指南 - 实现具备跨端通讯抽象与协议分层治理的流通道架构、支持端侧多维异步指令流管道化实战

Flutter 三方库 stream_channel 的鸿蒙化适配指南 - 实现具备跨端通讯抽象与协议分层治理的流通道架构、支持端侧多维异步指令流管道化实战

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 stream_channel 的鸿蒙化适配指南 - 实现具备跨端通讯抽象与协议分层治理的流通道架构、支持端侧多维异步指令流管道化实战 前言 在进行 Flutter for OpenHarmony 的复杂通讯系统（如实现自定义的二进制协议、跨进程 IPC 或与嵌入式设备进行长连接）开发时，如何将原始的、读写分离的 IO 映射为统一、双工的指令流？stream_channel 是一款专注于流通讯抽象的核心库。它将一个 Stream（入站）和一个 StreamSink（出站）封装为单一、可组合的对象。本文将探讨如何在鸿蒙端构建极致、清亮的流通讯底座。 一、原直观解析 / 概念介绍 1.1 基础原理 该库建立在“双工通道（

By Ne0inhk
【Linux】Linux基本使用和程序部署

【Linux】Linux基本使用和程序部署

🎬 那我掉的头发算什么：个人主页 🔥 个人专栏: 《javaSE》《数据结构》《数据库》《javaEE》 ⛺️待到苦尽甘来日 文章目录 * Linux环境搭建 * 环境搭建方式 * 使用云服务器 * 使用终端软件连接到Linux * Linux常用命令 * ls * pwd * cd * touch * cat * mkdir * rm * cp * mv * tail * vim * grep * ps * netstat * 搭建java部署环境 * apt * JDK * MYSQL * 部署web项目到Linux * 什么是部署 * 环境配置 * 构建项目并打包 * 上传jar包运行程序 * 杀死进程 Linux环境搭建 环境搭建方式 主要有四种： 1. 直接安装在物理机上。但是 Linux 桌面使用起来非常不友好。所以不建议。【不推荐】。 2. 使用虚拟机软件，

By Ne0inhk