创建 Flask 项目的时候主注意的细节

在使用Flask-migrate和Flask-script的时候，一般使用以下的目录结构：

 - myapp
 --- app.py
 --- config.py
 --- exts.py
 --- manage.py
 --- models.py

以下对各个文件的作用进行解释：

1. config.py：存放app配置的，一般把数据库的配置放在这个里面，比如代码如下：

   HOSTNAME = '127.0.0.1'
   PORT = '3306'
   DATABASE = 'myapp'
   USERNAME = 'root'
   PASSWORD = 'root'
   DB_URI = 'mysql+mysqldb://{}:{}@{}:{}/{}'.format(USERNAME,PASSWORD,HOSTNAME,PORT,DATABASE)
   

2. exts.py：把db=SQLAlchemy()这个变量放在这个文件中，而不是放在app文件中。这样做的目的是为了在大型项目中如果db被多个模型文件引用的话，会造成from your_app import db这样的方式，但是往往也在your_app.py中也会引入模型文件定义的类，这就造成了循环引用。所以最好的办法是把它放在不依赖其他模块的独立文件中。以后采用db.init_app(app)的方式和app进行绑定。

3. models.py：这个文件存放所有的模型，并且通过from exts import db的方式引用db。并且需要注意，因为这里使用的是flask-script的方式进行模型和表的映射，因此不需要使用db.create_all()的方式创建数据库。

   from exts import db
   class User(db.Model): 
       id = db.Column(db.Integer,primary_key=True) 
       username = db.Column(db.String(50)) 
   
       def __init__(self,username): 
           self.username = username
   

4. manage.py：这个文件用来存放映射数据库的命令，MigrateCommand是flask-migrate集成的一个命令，因此想要添加到脚本命令中，需要采用manager.add_command('db',MigrateCommand)的方式，以后运行python manage.py db xxx的命令，其实就是执行MigrateCommand的命令。如果想要让flask-migrate检测到模型，应该把models模块导入到这个文件中。

   from flask_migrate import Migrate,MigrateCommand
   from ext import db
   from flask_script import Manager
   from flask import Flask
   from constants import DB_URI
   import models
   # app = Flask(__name__)
   # 这个 app 可以通过主 app 文件导入
   # 也可以新建一个。建议使用导入的方式，
   # 因为不需要额外的配置了。
   app.config['SQLALCHEMY_DATABASE_URI'] = DB_URI
   app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True
   db.init_app(app)
   migrate = Migrate(app,db)
   manager = Manager(app)
   manager.add_command('db',MigrateCommand)
   
   if __name__ == '__main__': 
       manager.run()