PyCharm 社区版创建 FastAPI 项目

一、准备工作

1. 确保你已经安装了 Python 3.8+（FastAPI 推荐版本）
2. 打开 PyCharm 社区版

二、第一步：新建纯 Python 项目

1. 打开 PyCharm → 点击 New Project
2. 配置项目：
   • Location：选一个你能找到的文件夹
   • Python interpreter：选择你本地的 Python 环境
   • 点击 Create

三、第二步：安装 FastAPI 和 Uvicorn

在 PyCharm 底部打开 Terminal（终端），输入下面这一条命令安装依赖：

pip install fastapi uvicorn

• fastapi：核心框架
• uvicorn：运行服务的服务器

四、第三步：创建主程序文件

1. 在项目根目录右键 → New → Python File
2. 命名为：main.py

复制下面最简可用代码到文件里：

# 导入 FastAPI
from fastapi import FastAPI

# 创建应用实例
app = FastAPI()

# 编写第一个接口（访问根路径）
@app.get("/")
def read_root():
    return {"message": "Hello FastAPI！我在 PyCharm 社区版运行成功啦～"}

# 编写带参数的接口
@app.get("/name/{user_name}")
def say_hello(user_name: str):
    return {"message": f"你好，{user_name}！"}

五、第四步：启动 FastAPI 服务

回到 PyCharm 底部的 Terminal，输入启动命令：

python -m uvicorn main:app --reload --port 8000

命令解释

• main：你的文件名 main.py
• app：代码里的 app = FastAPI()
• --reload：代码修改后自动重启（开发必备）

六、第五步：测试接口

启动成功后，终端会显示：

Uvicorn running on http://127.0.0.1:8000

1. 浏览器访问

• 打开：http://127.0.0.1:8000
• 能看到 JSON 数据就说明成功了！

2. 自动生成的接口文档（超好用）

FastAPI 自带可视化文档，直接访问：

• Swagger UI：http://127.0.0.1:8000/docs
• ReDoc：http://127.0.0.1:8000/redoc

可以直接在网页上点按钮测试接口，不用写前端！

七、停止服务

在终端按：

Ctrl + C

最后：自己的笔记：   

安装ORM异步依赖 -> pip install sqlalchemy[asyncio] aiomysql

这一条是用户登录注册密码加密用的：（可能不对问ai）

pip install "passlib[bcrypt]==1.7.4"bcrypt==4.0.1