# 创建项目
[TOC=2,3]
## 安装 Node.js
ThinkJS 是一款 Node.js 的 MVC 框架,所以安装 ThinkJS 之前,需要先安装 Node.js 环境,可以去 [官方](https://nodejs.org/) 下载最新的安装包进行安装,也可以通过其他一些渠道安装。
安装完成后,在命令行执行 `node -v`,如果能看到对应的版本号输出,则表示安装成功。
ThinkJS 需要 Node.js 的版本 `>=0.12.0`,如果版本小于这个版本,需要升级 Node.js,否则无法启动服务。建议将 Node.js 版本升级到 `4.2.1`。
## 安装 ThinkJS
通过下面的命令即可安装 ThinkJS:
~~~
npm install thinkjs -g --verbose
~~~
如果安装很慢的话,可以尝试使用 [taobao](http://npm.taobao.org/) 的源进行安装。具体如下:
~~~
npm install thinkjs -g --registry=https://registry.npm.taobao.org --verbose
~~~
`注`:如果之前安装过 ThinkJS 1.x 的版本,可能需要将之前的版本删除掉,可以通过 `npm uninstall -g thinkjs-cmd` 命令删除。
## 创建项目
ThinkJS 安装完成后,就可以通过下面的命令创建项目:
~~~
thinkjs new project_path; #project_path为项目存放的目录
~~~
如果想用`ES6`特性来开发项目的话,可以创建一个`ES6`模式的项目,具体如下:
~~~
thinkjs new project_path --es6; #project_path为项目存放的目录
~~~
如果能看见类似下面的输出,表示项目创建成功了:
~~~
create : demo/
create : demo/package.json
create : demo/.thinkjsrc
create : demo/nginx.conf
create : demo/README.md
create : demo/www/
create : demo/www/index.js
create : demo/app
create : demo/app/common/runtime
create : demo/app/common/config
create : demo/app/common/config/config.js
create : demo/app/common/config/view.js
create : demo/app/common/config/db.js
...
create : demo/app/home/logic
create : demo/app/home/logic/index.js
create : demo/app/home/view
create : demo/app/home/view/index_index.html
enter path:
$ cd demo/
install dependencies:
$ npm install
run the app:
$ npm start
~~~
关于创建项目命令的更多信息,请见 [扩展功能 -> ThinkJS 命令](76389)。
## 安装依赖
项目安装后,进入项目目录,执行 `npm install` 安装依赖,可以使用 `taobao` 源进行安装。
~~~
npm install --registry=https://registry.npm.taobao.org --verbose
~~~
## 编译项目
如果创建项目时加上了 `--es6` 参数,代码需要编译后才能运行。那么需要先在项目下执行命令 `npm run watch-compile` ,这样文件有修改后就会自动编译了。
执行命令后会挂起一个进程,注意不要结束这个进程,其他命令可以再新开一个标签页里执行。
## 启动项目
在项目目录下执行命令 `npm start`,如果能看到类似下面的内容,表示服务启动成功。
~~~
[2015-09-21 20:21:09] [THINK] Server running at http://127.0.0.1:8360/
[2015-09-21 20:21:09] [THINK] ThinkJS Version: 2.0.0
[2015-09-21 20:21:09] [THINK] Cluster Status: closed
[2015-09-21 20:21:09] [THINK] WebSocket Status: closed
[2015-09-21 20:21:09] [THINK] File Auto Reload: true
[2015-09-21 20:21:09] [THINK] App Enviroment: development
~~~
## 访问项目
打开浏览器,访问`http://127.0.0.1:8360/`即可。
如果是在远程机器,需要通过远程机器的 IP 访问,同时要保证 8360 端口可访问。
- 快速入门
- 介绍
- 创建项目
- 项目结构
- 代码规范
- 升级指南
- 进阶应用
- 模块
- 控制器
- 视图
- 配置
- 路由
- 模型
- 介绍
- 事务
- 关联模型
- Mysql
- MongoDB
- SQLite
- Adapter
- 介绍
- Cache
- Session
- WebSocket
- Template
- 扩展功能
- thinkjs 命令
- 静态资源访问
- Middleware
- Service
- Cookie
- 错误处理
- 错误信息
- 数据校验
- 国际化
- 路径常量
- REST API
- 定时任务
- 线上部署
- 推荐模块
- API
- think
- think.base
- think.http.base
- http
- controller
- rest controller
- model
- model.mongo
- middleware