AdonisJS v7 已完成功能开发,正在进行最终验证。 了解更多

工具配置

工具配置

AdonisJS 严重依赖 TypeScript、Prettier 和 ESLint 来保持代码一致性,在构建时检查错误,更重要的是,拥有愉快的开发体验。

我们将所有选择抽象为即用型配置预设,供所有官方包和官方入门套件使用。

如果你想在用 TypeScript 编写的 Node.js 应用程序中使用相同的配置预设,请继续阅读本指南。

TSConfig

@adonisjs/tsconfig 包包含 TypeScript 项目的基本配置。我们将 TypeScript 模块系统设置为 NodeNext,并使用 TS Node + SWC 进行即时编译。

欢迎在基本配置文件应用程序配置文件包开发配置文件中探索选项。

你可以安装该包并按如下方式使用它。

npm i -D @adonisjs/tsconfig
# 确保存储安装以下包
npm i -D typescript ts-node-maintained @swc/core

创建 AdonisJS 应用程序时,从 tsconfig.app.json 文件扩展。(入门套件已预先配置)。

{
"extends": "@adonisjs/tsconfig/tsconfig.app.json",
"compilerOptions": {
"rootDir": "./",
"outDir": "./build"
}
}

为 AdonisJS 生态系统创建包时,从 tsconfig.package.json 文件扩展。

{
"extends": "@adonisjs/tsconfig/tsconfig.package.json",
"compilerOptions": {
"rootDir": "./",
"outDir": "./build"
}
}

Prettier 配置

@adonisjs/prettier-config 包包含用于自动格式化源代码以保持风格一致的基本配置。欢迎在 index.json 文件中探索配置选项。

你可以安装该包并按如下方式使用它。

npm i -D @adonisjs/prettier-config
# 确保同时安装 prettier
npm i -D prettier

package.json 文件中定义以下属性。

{
"prettier": "@adonisjs/prettier-config"
}

此外,创建一个 .prettierignore 文件以忽略特定文件和目录。

.prettierignore
build
node_modules

ESLint 配置

@adonisjs/eslint-config 包包含应用 linting 规则的基本配置。欢迎在基本配置文件应用程序配置文件包开发配置文件中探索选项。

你可以安装该包并按如下方式使用它。

我们的配置预设使用 eslint-plugin-prettier 来确保 ESLint 和 Prettier 可以协同工作而不会相互干扰。

npm i -D @adonisjs/eslint-config
# 确保同时安装 eslint
npm i -D eslint

创建 AdonisJS 应用程序时,从 eslint-config/app 文件扩展。(入门套件已预先配置)。

package.json
{
"eslintConfig": {
"extends": "@adonisjs/eslint-config/app"
}
}

为 AdonisJS 生态系统创建包时,从 eslint-config/package 文件扩展。

package.json
{
"eslintConfig": {
"extends": "@adonisjs/eslint-config/package"
}
}