后端Web框架【免费下载链接】thinkjsUse full ES2015 features to develop Node.js applications, Support TypeScript.项目地址https://gitcode.com/gh_mirrors/thi/thinkjs点击查看免费下载本文以 ThinkJS 官方快速开始文档为主线完整走通「安装 CLI → 脚手架建项目 → 安装依赖 → 启动服务 → 解读启动日志」的全流程并深入仓库源码揭示每一条命令背后的真实执行链路。读完本文你将掌握 ThinkJS 的完整初始化流程、think-cli脚手架机制、默认端口/进程等核心配置的底层含义并学会借助官方与自定义模板快速生成业务代码。ThinkJS 是一个使用完整 ES2015 特性开发 Node.js 应用的全栈 Web 框架官方定位同时支持 TypeScript见 README.md 与 packages/thinkjs/package.json 中的项目描述。它基于 Koa 构建内置控制器、模型、逻辑、中间件、RESTful、WebSocket、多进程集群等能力并配套提供think-cli脚手架工具让项目从创建到启动只需四条命令。下面我们从零开始把这四条命令逐一拆解。一、安装脚手架npm install -g think-cliThinkJS 的官方快速开始第一步是全局安装脚手架工具npm install -g think-clithink-cli是 ThinkJS 官方的命令行脚手架详见 packages/think-cli/README.md安装后系统会同时注册thinkjs与think-cli两个命令别名。这一点可以从它的 package.json 中看到bin: { thinkjs: bin/thinkjs, think-cli: bin/thinkjs }两个命令名都指向同一个入口文件 bin/thinkjs它基于commander定义了完整的子命令体系命令用途new从模板生成一个新项目list列出可用的官方模板module从模板添加一个模块controller从模板添加一个控制器service从模板添加一个服务model从模板添加一个模型middleware从模板添加一个中间件adapter从模板添加一个适配器migrate将旧项目迁移到 think-cli 2.0 规范sync同步最新版项目模板到本地缓存clean清空项目模板缓存值得说明的是命令入口本身是纯声明式的真正的执行逻辑分散在bin/commands/目录下对应子命令文件中如 bin/commands/new.js。安装完成后可以先执行thinkjs --help查看全部可用命令。二、创建项目thinkjs new demo安装好 CLI 之后创建项目的命令是thinkjs new demo2.1 命令行为解析从源码 bin/commands/new.js 可以看到这条命令的完整语义program .usage(project-name [template-name]) .option(-c, --clone, use git clone) .option(-m, --module, creating projects using multiple module mode);project-name是可选参数缺省时默认在当前目录生成项目等价于thinkjs new .template-name也是可选参数缺省使用仓库内置的default_template见 bin/commands/new.js 第 55 行-c / --clone使用git clone方式拉取模板拉取私有仓库模板时依赖 SSH 密钥-m / --module以多模块模式创建项目此时生成的项目目录结构会带有src/common与src/[moduleName]的划分。如果目标目录已经存在CLI 会通过inquirer弹窗询问Target directory exists. Continue?确认后才会继续生成。2.2 模板从哪来缓存与远程下载执行thinkjs new demo时实际由 lib/run.js 中的Run类完成生成。它的start()方法有一个关键分支start() { helper.isExist(this._cacheTemplatePath) ? this[GENERATE_CACHE]() // 本地已有缓存直接用 : this[GENERATE_REMOTE](); // 否则先同步远程模板到缓存 }也就是说CLI 会先把模板缓存到本地再从缓存生成项目。缓存目录定义在 packages/think-cli/config/index.jsconst templateCacheDirectory path.join(os.homedir(), .think-templates)即~/.think-templates目录。远程同步逻辑见 lib/sync.js官方模板会被拼接成think-template/template-name仓库名通过download-git-repo下载本地模板以./、../或绝对路径开头则直接通过 Metalsmith 复制到缓存目录。因此第一次创建项目需要联网拉取模板之后再次创建同一模板时会直接命中本地缓存离线可用执行thinkjs sync可以强制刷新缓存到最新版thinkjs clean可以删除缓存使下次创建重新拉取。2.3 官方模板与自定义模板think-cli提供了一批官方模板组织think-template下的仓库thinkjs list可以列出全部可用模板其中包括模板名定位standard功能完整的标准模板缺省模板apiAPI 应用模板vueThinkJS Vue 模板reactThinkJS React 模板typescriptThinkJS TypeScript CLI 模板除了官方模板也支持三种自定义模板来源# GitHub 仓库简写fork 官方模板后 thinkjs new my-project username/repo # 指定分支或标签 thinkjs new my-project username/repo#branch # 本地文件系统模板 thinkjs new my-project ~/fs/path/to-custom-template仓库简写最终会传给download-git-repo因此也支持bitbucket:username/repo等写法私有仓库可加-c参数改用git clone以便使用 SSH 密钥认证。关于如何从零编写自定义模板template目录 metadata.js/jsonprompts/skipCompile/completeMessage/各命令的 mapping 配置详见 packages/think-cli/README.md 的 Writing Custom Templates from Scratch 一节。2.4 生成管道的源码级拆解模板生成并非简单的文件复制而是由 lib/generate/index.js 组织的一条 Metalsmith 管道ask交互提问→ insertThinkjsInfoToPackage写入 thinkjs 元信息 → saveCtxToMetadata → fileFilter按 mapping 过滤文件 → mapping按规则重写文件路径→ normalizePath → confirmOverwrite → templateEJS 渲染其中fileFilter与mapping的规则来自模板metadata中对应命令的映射配置如new.default、new.multiModule。模板文件最终会使用 EJS 渲染见 lib/generate/template.js交互问答的结果会作为渲染数据注入因此模板里可以直接写% name %之类的插值语法。metadata.js中的skipCompile字段则用于跳过图片、字体等无需渲染的静态资源。三、安装依赖npm install项目脚手架生成完毕后进入项目目录安装依赖npm install这一步会依据脚手架生成的package.json安装框架本体与周边模块。在 packages/thinkjs/package.json 中可以看到框架的核心依赖构成了 ThinkJS 的运行时全家桶Web 内核koa应用内核、think-router路由、think-controller控制器基类、think-logic逻辑层、think-validator参数校验基础设施think-config配置、think-loader自动加载、think-helper工具函数、think-logger3日志运行增强think-cluster多进程集群、think-crontab定时任务、think-payload请求体解析、think-resource静态资源、think-trace错误追踪、think-mock-httpCLI/测试模拟请求周边能力think-pm2PM2 集成、think-meta、think-debounce等。需要说明的是当前仓库采用 pnpm workspace 管理见根目录 package.json 与 pnpm-workspace.yaml仓库中的示例项目 packages/think-demo/package.json 的start脚本为node development.js而脚手架生成的用户项目通常约定使用npm start启动具体以项目package.json为准。四、启动服务npm start依赖安装完成后即可启动npm start启动成功后控制台会输出类似下面的信息原文见 README.md其中版本号为示例值实际以所安装的 thinkjs 版本为准[2017-05-22 15:54:58.281] [INFO] - Server running at http://127.0.0.1:8360 [2017-05-22 15:54:58.283] [INFO] - ThinkJS version: 3.0.0-alpha1 [2017-05-22 15:54:58.284] [INFO] - Environment: development [2017-05-22 15:54:58.284] [INFO] - Environment: development [2017-05-22 15:54:58.284] [INFO] - Workers: 1这四条 INFO 日志并非随意打印它们的产出位置在 packages/thinkjs/lib/application.js 的_getMasterInstance()方法中think.logger.info(Server running at http://${host || 127.0.0.1}:${port}); think.logger.info(ThinkJS version: ${think.version}); think.logger.info(Environment: ${think.app.env}); think.logger.info(Workers: ${instance.options.workers});逐条解读Server running at http://127.0.0.1:8360服务监听地址与端口。端口 8360 是框架默认端口定义于框架默认配置 packages/thinkjs/lib/config/config.jsmodule.exports { port: 8360, // server port // host: 127.0.0.1, // server host workers: 0, // server workers num, if value is 0 then get cpus num stickyCluster: false, // sticky cluster createServer: undefined, // create server function startServerTimeout: 3000, // before start server time reloadSignal: SIGUSR2, // reload process signal onUnhandledRejection: err think.logger.error(err), onUncaughtException: err think.logger.error(err), processKillTimeout: 10 * 1000, // process kill timeout, default is 10s jsonpCallbackField: callback, jsonContentType: application/json, jsonpContentType: application/javascript, errnoField: errno, errmsgField: errmsg, defaultErrno: 1000, validateDefaultErrno: 1001 };其中workers: 0表示按 CPU 核数自动派生 Worker 进程数这就是日志里 Workers 一行的来源。此外host默认未配置所以显示127.0.0.1若需要对外提供服务可在项目src/config/config.js中覆盖host与port。Environment: development当前运行环境。示例项目 packages/think-demo/development.js 通过env: development指定加载器会在 packages/thinkjs/lib/loader.js 的initPath()中写入think.app.env并据此加载对应环境的配置如config.development.js。Workers: NMaster 进程启动的工作进程数。ThinkJS 默认以 cluster 多进程模式运行——Master 进程负责监听与调度lib/application.js 的runInMaster()调用thinkCluster.Master并startServer()每个 Worker 进程独立加载应用并创建 HTTP 服务runInWorker()中通过think.config(createServer)或原生http.createServer创建。这一设计使得代码热更新、多核利用成为内置能力。五、项目结构速览一个最小的 ThinkJS 应用以仓库自带的示例项目 packages/think-demo 为例脚手架生成的应用通常包含以下核心目录路径职责development.js/production.js开发 / 生产环境启动入口构造Application实例并run()src/config/全局配置、适配器配置、中间件、路由、定时任务等src/controller/控制器含 REST 基类src/logic/逻辑层参数校验、权限前置处理src/model/数据模型src/service/服务层src/bootstrap/master / worker 进程启动钩子view/模板视图www/static/静态资源开发入口 development.js 展示了最精简的启动方式const Application require(thinkjs); const babel require(think-babel); const watcher require(think-watcher); const notifier require(node-notifier); const instance new Application({ ROOT_PATH: __dirname, watcher: watcher, transpiler: [babel, { presets: [think-node] }], notifier: notifier.notify.bind(notifier), env: development }); instance.run();Application构造函数packages/thinkjs/lib/application.js会自动推断APP_PATH存在app目录则用之否则用src与RUNTIME_PATHruntime。开发模式下transpilerBabel负责把src下的 ES2015 代码转译后运行watcher监听源码变化并触发 Worker 热重载_watcherCallBack中调用masterInstance.forceReloadWorkers()。框架启动时由 lib/loader.js 的loadAll()完成核心装配加载配置think-config、初始化日志think-logger3、注入扩展think-loader的loadExtend、加载模型/服务/逻辑/控制器/路由/校验器、注册中间件、启动定时任务最后执行src/bootstrap/下的 master / worker 钩子。全局对象think在 lib/think.js 中创建挂载了think.appKoa 实例、think.Controller、think.Logic、think.Service、think.service()以及think.beforeStartServer()等。5.1 中间件与路由的默认编排示例项目的 src/config/middleware.js 展示了框架内置中间件的推荐编排顺序meta → resource开发环境静态资源→ trace错误追踪 → payload请求体解析→ router路由解析→ logic → controller而 src/config/router.js 则展示了路由自定义规则module.exports [ [/\/user/, user, rest], // RESTful 路由 [/test/:name, /testwww, redirect], // 重定向 [/post/:id/comments/:cid?, comment, rest], // 可选参数 [/^\/article\/list\/(\w)/, article/:1] // 正则捕获组映射 ];REST 控制器可直接继承示例 src/controller/rest.js 中的BaseRest它基于资源名与id自动实现了getAction查询、postAction新增、deleteAction删除、putAction更新四个动作。六、脚手架日常开发命令项目创建完成后think-cli的其余命令用于在既有项目中快速生成代码详见 packages/think-cli/README.md。它们的共同约束是必须在 ThinkJS 项目根目录执行源码通过utils.isThinkApp()校验项目package.json中是否声明了thinkjs依赖。6.1 控制器controller# 生成普通控制器src/home/controller/user.js thinkjs controller user home # 生成 REST 控制器 thinkjs controller user -rmodule-name如上例的home可选缺省时取项目根目录package.json中thinkjs.defaultModule字段仅多模块项目有效。-r参数生成的 REST 控制器会继承 REST 基类并自动映射 GET/POST/PUT/DELETE 动作。6.2 服务 / 模型 / 中间件thinkjs service user home # src/home/service/user.js thinkjs model user home # src/home/model/user.js thinkjs middleware user home # src/home/middleware/user.js三个命令的用法一致第一个参数是名称第二个可选参数是模块名仅多模块项目。6.3 适配器adapter# 生成 src/home/adapter/user/base.js类型 user、名称 base thinkjs adapter user/base home # 类型缺省为 basesrc/adapter/user/base.js thinkjs adapter user6.4 模块 / 迁移 / 同步 / 清理thinkjs module user # 多模块项目中新增模块名称缺省用 defaultModule thinkjs migrate # 将 think-cli 1.0 创建的项目迁移到 2.0 规范 thinkjs sync # 同步最新版项目模板到本地缓存 thinkjs clean # 清空模板缓存下次创建时重新拉取最新模板module命令只能在多模块项目中执行源码 bin/commands/module.js 会检查thinkjs.isMultiModule。七、生产部署与多进程要点进程模型默认 cluster 模式workers: 0表示按 CPU 核数派生 Worker可通过项目配置覆盖为固定值或开启stickyCluster会话保持与自定义createServer。PM2 集成框架提供think-pm2模块但注意 lib/application.js 的run()中明确抛错不能使用 pm2 cluster 模式需将exec_mode改为fork因为 ThinkJS 自身已管理 cluster。环境区分development.js/production.js分别以不同env启动配置系统会按环境加载对应配置文件中间件如trace、resource也会按think.env自动开关见 packages/think-demo/src/config/middleware.js。八、小结从npm install -g think-cli到npm startThinkJS 用四条命令完成了安装脚手架 → 生成项目 → 安装依赖 → 多进程启动的完整闭环。背后的机制环环相扣think-cli负责模板缓存与生成管道Application负责路径推断与 master/worker 双角色启动think.loader负责配置、扩展、模型、中间件的自动装配。无论你是想快速搭建一个标准 Web 应用、一个纯 API 服务还是接入 Vue/React/TypeScript 的完整前后端项目都可以在这套流程之上直接起步进一步的官方模板与自定义模板规范可继续查阅 packages/think-cli/README.md框架内核源码则可从 packages/thinkjs/lib/application.js 与 packages/thinkjs/lib/loader.js 入手深入研读。赞分享后端Web框架【免费下载链接】thinkjsUse full ES2015 features to develop Node.js applications, Support TypeScript.项目地址https://gitcode.com/gh_mirrors/thi/thinkjs点击查看免费下载相关推荐Relay 20 快速上手指南从零搭建基于 Vite React TypeScript 的 GraphQL 应用Relay 20 快速上手指南从零搭建基于 Vite React TypeScript 的 GraphQL 应用 本指南以 Relay 20 官方 Q前端开发工具Hackathon Starter 实战指南基于 Node.js Express 的全栈 Web 应用脚手架快速搭建手册Hackathon Starter 实战指南基于 Node.js Express 的全栈 Web 应用脚手架快速搭建手册 Hackathon Starte后端示例工程AI 应用behave异步步骤开发如何编写高性能BDD测试的完整指南behave异步步骤开发如何编写高性能BDD测试的完整指南 在当今快速迭代的软件开发环境中行为驱动开发BDD已成为确保代码质量与业务需求对齐的关键实践。测试开发工具上一篇多节点扩展指南如何用 Ray 集群加速 POLARIS 大规模强化学习训练下一篇十分钟搭好家庭游戏串流Sunshine 配 Moonlight 三步开玩创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考