如何用依赖清单复现环境?

依赖清单的作用，是把项目运行所需的第三方包及其版本说清楚，让另一台机器能够按同一组依赖搭建环境。它不能替代虚拟环境：清单描述“需要什么”，虚拟环境则隔离“装在哪里”。在 VS Code 中，应先为项目创建并选中 .venv，再安装清单中的依赖，避免包落到系统 Python 或其他项目里。

清单要记录什么

清单应尽量只列项目直接使用的依赖，并标明版本。只写包名，安装时可能得到不同版本；版本写得过于宽松，也可能让后续更新带来不兼容。反过来，把本机所有已安装的包都写进去，会混入无关内容，增加其他人安装和维护的负担。

python -m pip list 可以查看当前环境里的包，但它展示的是已安装内容，不等于经过整理的项目依赖清单。检查时应区分项目实际需要的包与环境中因其他用途存在的包。若项目还依赖特定的 Python 运行环境或操作系统行为，单靠包清单也无法完全消除这些差异。

用干净环境验证

整理清单后，最可靠的检查不是在原环境里重复运行，而是在新的项目虚拟环境中按清单安装，再运行项目入口脚本。若出现缺少模块，先确认安装依赖和运行脚本使用的是同一个解释器；VS Code 选择的路径应指向该项目的 .venv。安装时使用 python -m pip，比直接调用可能对应其他解释器的 pip 更容易保持一致。

清单只有经过“新环境安装—项目运行”的验证，才算真正可复现。后续增删依赖时同步更新清单，并再次做这项验证，才能让它持续反映项目实际需要。