运行python -m build报错找不到pyproject.toml或setup.py的问题咨询

• 检查配置文件名拼写与后缀：Windows系统默认隐藏已知文件后缀，容易出现pyproject.toml实际被保存为pyproject.toml.txt的情况；Linux、macOS系统区分文件名大小写，确认文件名是全小写的pyproject.toml，没有大小写拼写错误。
• 确认命令执行路径正确：在终端执行pwd（Linux/macOS）、echo %cd%（Windows CMD）或Get-Location（Windows PowerShell），确认当前工作目录就是存放pyproject.toml的package_root目录，没有误进入上级目录、src目录或其他路径。
• 检查依赖工具版本与环境匹配：确认当前调用的Python是你预期使用的环境（虚拟环境/全局环境），执行以下命令升级相关打包依赖避免工具bug：

  pip install --upgrade build setuptools wheel
  

• 检查文件读取权限：确认当前系统用户对pyproject.toml、setup.cfg等配置文件有读取权限，Linux/macOS可执行ls -l pyproject.toml查看权限配置，Windows可右键文件查看属性-安全选项卡的权限配置。
• 排除软链接/快捷方式问题：如果pyproject.toml是软链接或者Windows快捷方式，替换为实际存放在项目目录下的实体文件再尝试打包。
• 检查文件编码格式：确认pyproject.toml保存为无BOM的UTF-8编码，异常编码会导致解析器无法识别文件内容，误判文件不存在，可通过代码编辑器重新保存为正确编码。
• WSL环境特殊问题：如果是在WSL环境下操作位于Windows挂载目录的项目，容易出现文件同步、权限异常问题，将项目移动到WSL本地目录（如/home/用户名/路径下）再尝试打包。

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