sublime text 仅是编辑器，不运行 flask；flask-restful 需手动注册 resource 到 api 实例，路径参数须匹配方法签名，调试应通过终端执行 flask run，错误响应需用 abort() 显式设状态码。
Sublime Text 本身不运行 Flask 或 Flask-RESTful，它只是编辑器；所有服务启动、路由注册、资源定义都得靠命令行执行和代码逻辑驱动。别指望右键“运行”就能起 API 服务——这是最常被误解的起点。
Flask-RESTful 的 Resource 类必须显式注册到 Api 实例
很多人写完 class TaskResource(Resource) 就以为路由自动生效了，结果 /tasks 404。根本原因是：Flask-RESTful 不像原生 Flask 那样靠 @app.route 绑定，它依赖 Api 实例统一管理路由映射。
-
Api初始化后，必须调用api.add_resource(TaskResource, '/tasks')才真正挂载路由 - 路径参数要和 Resource 方法签名一致，比如
@app.route('/tasks/<task_id>')</task_id>对应def get(self, task_id): - 多个 Resource 注册顺序无关，但重复路径会覆盖（后注册的生效）
- 如果用蓝图（Blueprint），需先
api.init_app(blueprint)，再在 blueprint 中 add_resource
Sublime 中调试 Flask-RESTful 接口不能只靠 SublimeREPL
SublimeREPL 只能交互式执行 Python 代码，无法启动完整 WSGI 应用上下文，所以你在 REPL 里 import app 然后 run()，大概率报 Working outside of application context 或找不到 request 对象。
- 正确做法是：保存文件（如
app.py），终端执行FLASK_APP=app.py flask run（推荐）或python app.py - 若用
flask run，确保app实例名为app，或通过FLASK_APP=module:instance_name指定 - 调试时加
--debug和--reload（Flask 2.3+ 默认启用 reload），避免每次改完手动重启 - Postman / curl 测试比浏览器更可靠，尤其对 POST/PUT/DELETE 请求体和 header 控制更直接
Flask-RESTful 的错误响应默认不带状态码，容易掩盖问题
直接 return {'error': 'not found'} 会返回 200 OK，前端收不到 HTTP 错误信号。Flask-RESTful 提供了 abort() 和自定义错误处理器，但新手常忽略。
-
from flask_restful import abort，然后abort(404, message="Task not found")—— 这会返回 404 + JSON body - 全局错误处理要用
api.error_handlers，例如api.error_handler(ValidationError)(handle_validation_error) - 不要在 Resource 方法里用
raise Exception()，Flask-RESTful 会捕获但返回 500 且无结构化信息 - 开发期建议开启
app.config['ERROR_404_HELP'] = False，避免默认提示干扰调试
Flask-RESTful 的轻量优势在于少封装、易调试，但代价是很多细节得手动控制——比如 request 解析、状态码、异常传播。Sublime 不提供智能感知或自动补全，reqparse 参数校验、marshal_with 序列化这些关键逻辑，全靠你写对函数名和字段名。一个拼错的 add_argument('user_id', type=int) 就会让整个 POST 接口静默失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
