Skip to content

Conversation

@godmial
Copy link

@godmial godmial commented Nov 28, 2025

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 ModuleNotFoundError errors when using commands like pkgs or scons --menuconfig. This is due to PEP 668 restrictions that prevent pip install from installing packages into system-wide locations.

Solution

Added a new "Troubleshooting" section in the README.md that:

  • Explains the issue with PEP 668 restrictions on Ubuntu 23.04+
  • Provides a clear solution using system package manager (apt install)
  • Lists the specific packages needed: python3-tqdm and python3-kconfiglib

Changes

  • Added "Troubleshooting" section after "Prepare Env" section in README.md
  • Includes instructions for Ubuntu 23.04+ users to manually install missing dependencies

Testing

  • Verified the documentation format and clarity
  • Confirmed the solution works on Ubuntu 23.04+ systems

Related Issues

This addresses installation issues on newer Ubuntu versions where PEP 668 restrictions cause module import errors after installation.

@dongly
Copy link
Contributor

dongly commented Nov 28, 2025

#257
应是修改安装脚本,软件包安装在虚拟环境(现windows 就是安装在虚拟环境),而不是加说明

@godmial
Copy link
Author

godmial commented Nov 28, 2025

#257 应是修改安装脚本,软件包安装在虚拟环境(现windows 就是安装在虚拟环境),而不是加说明

在虚拟环境中可以成功安装依赖,但是我这边安装成功之后使用scons命令还是失败,可能是因为命令仍然使用的是系统路径而不是虚拟环境

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants