PyPI包README更新咨询：无需上传新版本能否修改？

能不能不发新版本就改已上线包的 README？ #

不行。PyPI的规则是已发布的版本内容完全不可修改，不管是README、代码还是其他资源，目的是确保每个版本的包内容固定可追溯，避免用户获取的内容和最初发布的不一致。

用 Poetry 更新 README 的标准操作 #

既然必须发新版本，针对文档修改的场景，最快的流程是：

• 先更新版本号：因为PyPI不接受同一版本号的重复上传，这类小改动建议用修订版号（比如从1.0.0升成1.0.1），符合语义化版本规范。用Poetry的话直接跑：poetry version patch，它会自动修改pyproject.toml里的版本号。
• 确认README的修改没问题后，重新构建发布：执行poetry publish --build，这次版本号变了，就不会出现“同名文件”的报错。

关于文档修改的测试说明 #

虽然只是改文档，确实不需要跑完整的测试流程，但版本号递增是PyPI的硬性规则，必须遵守。你可以在CHANGELOG.md里注明“仅更新README文档，无功能变更”，让用户清楚这次版本更新的内容。

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