如何正确导入朋友的Flask VSCode项目并同步配置运行？

一、先搞定Python依赖（核心前提） #

• 先检查项目根目录是否有requirements.txt：
  1. 打开终端，进入项目文件夹，创建并激活虚拟环境（避免污染全局Python环境）：

     # 创建虚拟环境
     python -m venv venv
     # Windows激活虚拟环境
     venv\Scripts\activate
     # Mac/Linux激活虚拟环境
     source venv/bin/activate
     

  2. 激活后执行安装命令：

     pip install -r requirements.txt
     

• 如果没有requirements.txt，直接让朋友在他的项目虚拟环境里执行pip freeze > requirements.txt，把生成的文件发给你，再重复上面的安装步骤。

二、同步VSCode项目配置 #

VSCode的项目专属配置都存在.vscode文件夹里，让朋友把这个文件夹完整发给你，覆盖你本地项目的同名文件夹（如果有的话）。这个文件夹里通常包含：

• settings.json：指定Python解释器路径、环境变量文件路径等
• launch.json：调试运行的核心配置（比如Flask启动参数、入口文件路径）
• tasks.json：自定义任务脚本（比如一键启动服务）

如果朋友没提供，手动配置步骤：

1. 按Ctrl+Shift+P（Mac用Cmd+Shift+P），输入Python: Select Interpreter，选择你刚创建的虚拟环境里的Python解释器（路径一般是venv/bin/python或venv\Scripts\python.exe）
2. 创建调试配置：点击左侧调试面板，选择「创建launch.json文件」，选「Flask」，自动生成配置后，检查program字段是否指向项目的入口文件（比如app.py或wsgi.py）
3. 新建.vscode/settings.json，添加基础配置：

   {
     "python.pythonPath": "venv/bin/python", // 替换成你本地的虚拟环境Python路径
     "python.envFile": "${workspaceFolder}/.env" // 如果项目用了环境变量文件
   }
   

三、检查Flask项目启动条件 #

• 确认项目入口文件：一般是app.py，里面要有app.run()代码，或者支持flask run启动（需要设置FLASK_APP环境变量）
• 用flask run启动的话，先在终端设置环境变量：

  # Windows系统
  set FLASK_APP=app.py
  set FLASK_ENV=development
  # Mac/Linux系统
  export FLASK_APP=app.py
  export FLASK_ENV=development
  # 启动服务
  flask run
  

• 如果项目用到了.env文件（存放数据库密钥、API密钥等配置），让朋友把这个文件也发给你，放在项目根目录。

四、安装必备VSCode扩展 #

打开VSCode扩展商店，搜索安装以下扩展：

• Python：微软官方扩展，提供代码补全、调试、格式化等核心功能
• Pylance：增强Python代码分析、类型提示的语言服务器
• Flask Snippets：快速生成Flask常用代码片段，提升开发效率

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