【要約】動いているPython環境を壊さず依存関係を固定する [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者がレガシーなPython環境の保守を行う際、依存関係の管理が不透明であるという問題に直面する。環境の現状を正確に把握できないことで、以下の課題が生じる。
- ・
requirements.txtが存在せず、依存関係の構成が不明である。 - ・
pip freezeを使用すると、対象外のパッケージまで混入し、更新の影響範囲が広がる。 - ・Playwright等のツールにおいて、パッケージとブラウザリビジョンの対応関係が不明確である。
// Approach
開発者は、既存環境を破壊せずに依存関係を特定するため、以下のステップで慎重に作業を進める。
- ・ソースコードの
import文を確認し、対象アプリが実際に使用するパッケージを洗い出す。 - ・
pip3 show <package>を用い、PyPIの最新版ではなく、現環境で動作している実測バージョンを取得する。 - ・使い捨ての仮想環境を作成し、
pip install -r requirements.txtで依存関係の解決可否を事前に検証する。 - ・判断理由（なぜ最新版ではなく実測値か）を
requirements.txtのコメントに記録する。
// Result
この手法により、開発者は本番環境を汚染することなく、安全な依存関係の固定を実現できる。具体的には以下の成果が得られる。
- ・不要なパッケージの混入を防ぎ、更新時の副作用を最小限に抑えられる。
- ・「なぜそのバージョンを選んだか」という判断理由が残り、将来のメンテナンス性が向上する。
- ・依存関係の固定が、単なる停止ではなく、安全な更新のための出発点となる。
Senior Engineer Insight
> 「最新」を追うのではなく「実測」を記録する姿勢は、安定稼働を最優先する現場において極めて重要だ。
pip freeze による一括出力は、環境の汚染を招く。ソースコードからの逆引きと、隔離環境での検証プロセスは、CI/CDの堅牢性を高める。ただし、手動での import 確認は漏れのリスクがある。大規模環境では、静的解析ツールを併用し、このプロセスを自動化すべきだ。