Flask应用启动报错：无法从werkzeug.urls导入url_quote

问题原因 #

你遇到的是Flask与Werkzeug版本不兼容导致的错误：旧版本的Flask依赖Werkzeug中的url_quote函数，但新版本Werkzeug（2.3及以上）已经移除了这个函数，而你的项目未指定固定依赖版本，新环境默认安装了高版本Werkzeug，因此出现导入失败。

解决步骤 #

方法1：安装兼容的指定版本 #

卸载当前不兼容的包，重新安装适配旧项目的版本：

pip uninstall flask werkzeug -y
pip install flask==2.2.5 werkzeug==2.2.3

该版本组合已验证可兼容旧项目对url_quote的依赖。

方法2：复用旧项目的依赖清单 #

如果你之前保存过requirements.txt文件，直接执行以下命令恢复旧环境：

pip install -r requirements.txt

若没有该文件，建议导出当前适配环境的依赖清单，方便后续复用：

pip freeze > requirements.txt

额外说明 #

项目从Windows切换到Linux环境并非问题核心，本质是新环境默认安装了最新版依赖包，打破了旧项目的兼容性。固定依赖版本是避免这类跨环境、跨时间兼容性问题的最佳实践。

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