• 软件开发目录规范


    1. 为什么要有好的目录结构

    好的设计项目目录结构,就和编码风格一样,是每个程序员都有的风格,但是在流水化标准化作业过程中,个

    性和风格是不被鼓励的。如果你去维护一个非常不好读的项目,虽然实现逻辑并不复杂,但是对后续的维护者来说

    就是灾难。

    [优点]

    1. 可读性高
    后续维护人员可以一眼看懂目录结构,不必为复杂混乱的层次耗费大量精力。测试文件在哪,配置文
    件在哪会被放置在规范操作的地方,可以让后续人员快速的了解这个项目。
    
    2. 可维护性高
    看清目录架构之后,维护者可以将后续新增的文件和代码按照规范放置在规定的地方,虽然后续代码
    和文件增多,但是项目目录并不会混乱,仍然能够快速组织良好
    所以说,保持一个层次清晰的目录结构是非常必要的,也是体现一个程序员思路和视野格局的一个标准
    

    2. 目录组织的方式

    目前各个开发语言在工程目录结构方面,已经取得了一些共识的目录结构.

    例如,如下的一个简单的ATM目录结构,开发人员可以快速的了解项目的启动入口,用户层模块,逻辑接口层模

    块,数据处理模块,日志模块等等。

    ATM/
    |-- bin/
    |   |-- start.py
    |
    |-- core/
    |   |-- src.py
    |
    |-- conf/
    |   |-- settings.py
    |
    |-- lib/
    |   |-- common.py
    |
    |-- api/
    |   |-- api.py
    |
    |-- db/
    |   |-- db_handle.py
    |
    |-- run.py
    |-- setup.py
    |-- requirements.txt
    |-- README
    
    • ATM:项目目录

    • bin/:存放启动文件,一般也可以放在项目的根目录下

    • core/:存放业务逻辑相关代码

    • conf/:存放配置文件

    • lib/:存放程序中常用的自定义模块

    • api/:存放接口文件,接口主要用于为业务逻辑提供数据操作

    • db/:存放操作数据库相关文件,主要用于与数据库交互

    • run.py:程序的启动文件,一般放在项目的根目录下,因为在运行时会默认将运行文件所在的文件夹作为

      sys.path的第一个路径,这样就省去了处理环境变量的步骤,也可以放在bin下,两者选其一

    • setup.py:安装、部署、打包的脚本

    • requirements.txt:存放软件依赖的第三方模块

    • README: 项目说明文件

    关于README的内容,这个应该是每个项目都应该有的一个文件,目的是能简要描述该项目的信息,让读者快速

    了解这个项目。它需要说明以下几个事项:

    1、软件定位,软件的基本功能;
    
    2、运行代码的方法: 安装环境、启动命令等;
    
    3、简要的使用说明;
    
    4、代码目录结构说明,更详细点可以说明软件的基本原理;
    
    5、常见问题说明。
    
  • 相关阅读:
    Windows安装使用wget
    Ubuntu16.04 安装和卸载MySQL数据库
    申请百度翻译API
    Linux配置JDK
    vmware的三种网络连接模式
    3、linux-目录管理:mkdir、rmdir、mv
    2、linux-添加组groupadd、修改组groupmod、删除组groupdel
    1、linux-用户管理useradd,usermod,userdel
    在Linux操作系统里有Ext2、Ext3、Linux swap和VFAT四种格式
    第四次作业 简易计算器
  • 原文地址:https://www.cnblogs.com/xcymn/p/14135612.html
Copyright © 2020-2023  润新知