如何正确开始一个python项目（django为例）

写在前面：

如果随意创建一个python项目，那么该项目往往会很依赖本地的环境，当项目移植到其他机器上，往往会出现兼容性问题（python版本不一致，缺少包等）。本文以django项目为例介绍如何开始一个python项目，包括创建干净的python虚拟环境，安装需要的包，创建工程，git托管4个步骤。

0. 准备工作：

本机先需要安装好python2.*，git，virtualenv工具。关于如何安装，方法很多，自行google。

1. 创建虚拟环境

1. 为该项目创建一个目录,并进入该目录下

   $ mkdir ~/WorkSpace/django_test/
   $ cd ~/WorkSpace/django_test/
   

2. 创建虚拟环境

   $ virtualenv --python=python2.7 django_test_env
   

   这时，在当前目录下就会创建一个django_test_env目录，里面bin/目录下有新python和lib/目录下有一些必要的包。“–python=python2.7”可以省略，会默认选择本机中已安装的python版本，还装了pip等必要工具。

3. 启用该虚拟环境

   $ source django_test_env/bin/activate
   

   这时，bash界面就会变成“(django_test_env)bogon:django_test liuweijie$ ”此时执行python脚本的interpreter就是django_test_env里的python2.7,引用的包也是从django_test_env的lib找，而与本机的环境无关。

   如果要退出虚拟环境，执行以下命令

   $ deactivate
   

2. 安装需要的包

安装django包

    $ pip install django==1.8.3

这时django就会安装好，安装在django_test_env中,django-admin在bin/目录下,django的一些包在lib/目录下。

3. 创建工程

创建django工程

    $ cd ~/WorkSpace/django_test/
    $ django-admin.py startproject django_test

这时django工程就创建好了，如果要为django创建app可以执行以下命令

    $ python manage.py startapp app-name

4. git管理

1. 将该项目用git管理起来

   $ cd ~/WorkSpace/django_test/django_test/
   $ git init
   

2. 添加.gitgnore文件

   $vim .gitignore
   

   根据需要写该文件的内容，示例如下：

   # Byte-compiled / optimized / DLL files
   __pycache__/
   *.py[cod]
   
   # C extensions
   *.so
   
   # Distribution / packaging
   .Python
   .idea/
   .idea/*
   *.egg-info/
   .installed.cfg
   *.egg
   
   # PyInstaller
   #  Usually these files are written by a python script from a template
   #  before PyInstaller builds the exe, so as to inject date/other infos into it.
   *.manifest
   *.spec
   
   # Installer logs
   pip-log.txt
   pip-delete-this-directory.txt
   
   # Unit test / coverage reports
   htmlcov/
   .tox/
   .coverage
   .coverage.*
   .cache
   nosetests.xml
   coverage.xml
   *,cover
   
   # Translations
   *.mo
   *.pot
   
   # Django stuff:
   *.log
   
   # Sphinx documentation
   docs/_build/
   
   # PyBuilder
   target/
   

3. 提交第一个commit

   $ git add .
   $ git commit -m "init project."
   

自此，一个django项目创建完成，可以开始安心编写项目了, 建议创建一个dev分支进行开发。可以用pycharm等ide打开这个项目。