发布后须立即在干净虚拟环境中验证import、CLI执行、版本一致性及最低Python版本兼容性，避免用户首用即崩。
发布后立刻检查 import 是否失败
模块能装上不等于能导入，尤其当包结构改过、__init__.py 漏删或新增了循环引用时，import 会在运行时才炸。别等用户报错才反应过来。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在干净虚拟环境中
pip install发布的 wheel 或 sdist，然后逐个import公共模块（如from mypkg import core、import mypkg.utils） - 重点测入口模块和文档里第一个示例用到的模块名，它们最常被用户直接敲
- 如果用了
pyproject.toml的[project.optional-dependencies]，记得也装上对应 extra 再试，比如pip install "mypkg[dev]" - Windows 用户可能遇到
ModuleNotFoundError: No module named '_ctypes'—— 这不是你代码的问题，是他们没装完整 Python，但你要在 CI 里用 Windows 环境跑一遍 import，早发现早加文档说明
pkg_resources.get_distribution() 和 importlib.metadata.version() 返回值是否一致
很多 CLI 工具靠这个打版本号，用户截图问“为什么 mypkg --version 显示 0.1.0，但 pip show mypkg 是 0.2.0？”——八成是打包时元数据没刷进去。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 发布前，在安装后的环境中分别运行：
python -c "import pkg_resources; print(pkg_resources.get_distribution('mypkg').version)"和python -c "from importlib import metadata; print(metadata.version('mypkg'))" - 确保
setup.py或pyproject.toml中的版本字段和源码里硬编码的__version__同步；如果用了动态版本（如setuptools-scm），CI 打包时必须有 .git 目录或正确配置fallback_version - 如果用
build --wheel但没清 dist/，旧 wheel 可能被 pip 优先选中——每次发布前手动删掉dist/和build/
CLI 命令能否在 PATH 中直接执行（不进 Python 解释器）
用户不会输 python -m mypkg.cli，他们就敲 mypkg-do-this。entry_points 配错了，命令就根本找不到。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 安装后立刻运行
which mypkg-do-this（macOS/Linux）或where mypkg-do-this（Windows），确认路径指向 site-packages 下的 wrapper 脚本 - 检查
pyproject.toml中[project.entry-points."console_scripts"]的键名是否含非法字符（只允许字母、数字、下划线、连字符），值是否为module:attr格式，比如"mypkg-cmd = mypkg.cli:main" - 如果 CLI 函数带参数解析（如
argparse），在 smoke 测试里至少跑一次mypkg-cmd --help，避免因导入失败导致 help 都打不出来 - Windows 上脚本扩展名是
.exe，但内容仍是纯文本；如果用 pyinstaller 打包过，会覆盖标准 entry point 行为——确认你发布的不是那个
关键函数在最低支持 Python 版本下是否真能跑通
写 requires-python = ">=3.8" 不代表 3.8 就稳。类型提示里的 Literal、Self、TypedDict 的关键字参数，3.8 默认不认；pathlib.Path.walk() 是 3.12 才加的——这些地方一跑就 AttributeError 或 SyntaxError。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- CI 必须跑最低版本（如 3.8）+ 最高版本（如 3.12）两套测试环境，不能只靠本地 3.11
- 烟雾测试里挑 2–3 个核心路径：比如初始化客户端、读一个配置文件、吐出一行 JSON——用最简输入触发主干逻辑，不追求覆盖率，只验“不崩”
- 如果用了
typing_extensions，确认install_requires里写了对应版本约束，例如typing-extensions>=4.0.0; python_version - Mac M1/M2 用户可能用 Rosetta 或原生 Python，arm64 架构下某些 C 扩展（如
cryptography）二进制不兼容——在 Apple Silicon 机器上装一遍，比只信 CI 更可靠
最容易被跳过的其实是环境变量和当前工作目录的影响：烟雾测试得在空目录下跑，且不带 PYTHONPATH、MY_PKG_DEBUG=1 这类开发期变量，否则你以为稳了，用户一开终端就挂。
