PyCharm 使用Github托管Django项目

不论是对于教程代码免费分享的须要，仍是项目开发过程当中的版本管理，Github都是咱们首选的开源代码仓库，若是你没有私有仓库，而且不用保护代码，那么将项目上传到Github上是最佳的选择。

关于如何使用Git软件请自行学习，或许之后有空我也会写点教程。如何在PyCharm中配合Github，在本站的博客中有一篇《PyCharm 在PyCharm中使用GitHub》，可供你们参考。

1、 建立requirement.txt文件

"requirement.txt"（可自命名）文件是一个项目的依赖库文件，能够经过下面的方式自动生成：

进入虚拟环境，切换到项目根目录下，使用pip工具的 freeze（冻结）参数。

(mysite_env) F:\Django_course\mysite>pip freeze > requirement.txt

打开文件"requirement.txt"，其内容以下：

Django==1.11.7
django-simple-captcha==0.5.5
olefile==0.44
Pillow==4.3.0
pytz==2017.3
six==1.11.0

他人若是拷贝了咱们的代码，要安装第三方库依赖的话，只须要：

pip install -r requirement.txt

就能够一次性安装好全部的库了。

2、建立.gitignore文件

在项目代码中，有一些文件是不能上传的，好比密码文件、数据库文件、核心配置文件等等，还有一些是不用上传的，好比临时文件。为了让git自动忽略这些文件，咱们须要建立一个忽略名单。

方式1：

在项目根目录下新建一个".gitignore"文件，这里可能须要你在Pycharm下安装ignore插件，以下图所示：

我这里是已经安装好了，新安装的话，要在搜索栏里搜索到插件后再安装。

在".gitignore"文件里写入下面的内容：

.idea
settings.py db.sqlite3 mysite/__pycache__/ 

方式2：

打开设置，如图。

这些文件将不会上传到Github中，也不会进行版本管理。

3、特殊文件处理

对于settings.py文件有个问题，若是没有这个文件是没法运行Django项目的，可是settings中又可能包含不少关键的不可泄露的部分，好比SECRET_KEY：

　# SECURITY WARNING: keep the secret key used in production secret!
　SECRET_KEY = '81$k-x)bqrs4!!kjyifja)g=^zi*j@62$&n_c%4&ic*ni5q%dd'

还有数据库的IP/port、用户名和密码，邮件发送端的用户名和密码，这些都是绝对不能泄露的。

那怎么办呢？简单！复制settings文件，并重命名为settings.example.py文件，放在同一目录里，把敏感信息、密码等修改或删除。使用者看到这个文件名，天然会明白它的做用。

4、添加说明文件和许可文件

一般咱们要给Github的仓库添加说明文件和许可文件。

在项目根目录下建立一个"README.md"文件，这是markdown格式的。在文件里写入项目说明，使用方法，注意事项等等全部你认为须要说明的东西。

对于许可文件LICENSE，若是你暂时不想公开受权，或者不知道用哪一种受权，能够暂时不提供。

下面是一个APACHE2.0受权的范例：

 mysite - User login and register system

 Copyright 2017- www.liujiangblog.com

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.

5、上传代码

在上传过程当中，确认文件列表的时候，必定要注意查看没有保密文件被上传。

等待一会，项目文件上传完毕后，进入Github的仓库页面，以下所示：

 

点击进入详细页面：

 

如今，全部人均可以经过下面的方式，下载和使用本项目的源代码了：

git clone https://github.com/*******_project_1

6、使用Github仓库中的源码

若是你不是从教程的开始一步步地实现整个项目，而是直接使用从Github上Copy下来的整个源码，那么你可能须要作一些额外的工做，好比：

• 建立虚拟环境
• 使用pip安装第三方依赖(根据requirement.txt)
• 修改settings.example.py文件为settings.py
• 运行migrate命令，建立数据库和数据表
• 运行python manage.py runserver启动服务器

而在Pycharm中运行服务器的话，可能还须要作一些额外的工做，好比：

• 配置解释器
• 配置启动参数

由于你本地Pycharm的配置状况，可能会发生不一样的问题，须要根据实际状况实际处理，下面给两张配置图，供你们参考（通常状况下只填Name，Host和Port便可，其他内容会自动关联好）：

以上内容，都通过实际测试，若是你依然不能顺利启动服务器，请详细检查Pycharm的配置。

 

　　至此，转载请注明出处。

[参考出处：http://www.liujiangblog.com/course/django/115，有改动]

[ 本站相关连接：>>Django部署 ]