Add troubleshooting section for Ubuntu 23.04+ installation issues #269
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
|
#257 |
Author
在虚拟环境中可以成功安装依赖，但是我这边安装成功之后使用scons命令还是失败，可能是因为命令仍然使用的是系统路径而不是虚拟环境 |
Open
dongly
added a commit
to dongly/env
that referenced
this pull request
Jan 31, 2026
- 重构了安装脚本
- 将安装脚本统一移动到 tools 目录
- 更新 README 文档
- 支持中/英双语
- Linux/MacOS 统一使用虚拟环境
RT-Thread#257
RT-Thread#269
- 可能自定义安装目录(默认: ~/.rt-env)
RT-Thread#230
- 根据 IP,决定是否使用国内镜像(软件/仓库/PyPI)
- 多平台共用的操作由 touch_env.py 统一处理,方便维护
- Linux / MacOS 整合为一个安装文件 install.sh
- 可选是否安装 pyocd
- 对已经安装 ENV, 可选择多种保留策略(主要是因工具链下载时间太长了)
- 激活后显示欢迎词
- 可设定 env、package 、sdk 仓库的地址及分支,方便测试这些仓库的更改
- Windows 安装脚本:
- 设置 ps 脚本的执行策略
- 自动搜索系统中的 Python
- 或自动下载并安装便携式 Python
- 为 Python 设置长路径支持
- 自动下载安装 Git 最新版
- 使用了 AI 辅助
已测试平台:
- Windows 11: Windows PowerShell 5.1
- Windows 11: PowerShell 7.5
- Windows WSL2: Ubuntu 24.04.3 LTS
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR adds a troubleshooting section to the README.md to help users resolve installation issues on Ubuntu 23.04 and later versions.
Problem
On Ubuntu 23.04+, the installation script may complete successfully, but users may encounter
ModuleNotFoundErrorerrors when using commands likepkgsorscons --menuconfig. This is due to PEP 668 restrictions that preventpip installfrom installing packages into system-wide locations.Solution
Added a new "Troubleshooting" section in the README.md that:
apt install)python3-tqdmandpython3-kconfiglibChanges
Testing
Related Issues
This addresses installation issues on newer Ubuntu versions where PEP 668 restrictions cause module import errors after installation.