PyCharm下Flask项目：端口冲突与调试模式失效的解决方法

在使用PyCharm开发Flask项目时，特别是同时运行多个Flask应用，可能会遇到端口号固定和调试模式失效的问题。即使修改了端口和调试设置，仍然沿用之前的配置。

问题现象：

假设在PyCharm中创建了两个Flask应用，“应用一”和“应用二”。在“应用二”中将端口号修改为5001，并启用调试模式(debug=True)，但运行时却显示“应用一”的结果，端口号仍然是5000。

代码示例 (应用二)：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return "Flask应用二首页"

if __name__ == '__main__':
    app.run(debug=True, port=5001)

问题根源：

PyCharm在同时运行多个Flask应用且这些应用使用相同端口或配置文件时，可能由于缓存机制导致之前的配置覆盖新的设置。

解决方案：

PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。

下载

1. 清除PyCharm缓存: 通过File -> Invalidate Caches / Restart...选项清除PyCharm缓存并重启，这能有效解决缓存导致的配置冲突。

2. 检查运行配置: 在Run -> Edit Configurations...中仔细检查“应用二”的运行配置，确保端口号(5001)和调试模式(debug=True)设置正确无误。

3. 避免端口冲突: 尽量使用不同的端口号运行各个Flask应用，避免端口占用冲突。

4. 代码端口设置检查: 核实代码中设置的端口号是否准确，并检查是否存在其他配置文件覆盖了代码中的端口设置。

通过以上步骤，即可有效解决PyCharm中Flask项目端口固定和调试模式失效的问题，确保应用能够正常运行在指定的端口并启用调试功能。