# @cprussin/tsconfig 中文文档

规范地址：https://npmcn.com/package/%40cprussin/tsconfig/

版本：5\.0\.0
npm 元数据更新时间：2026-04-22T16:43:39.643Z
中文译文更新时间：2026-11-10T21:37:38.130Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cprussin/tsconfig
原文对照：https://npmcn.com/package/%40cprussin/tsconfig/?lang=original
项目主页：https://www.cprussin.net/modules/_cprussin_tsconfig.html
源码仓库：https://github.com/cprussin/cprussin-monorepo

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.6 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：typescript ^6\.0\.3
- 首次发布：2023-05-05T15:59:28.628Z
- 最新版本发布：2026-04-22T16:43:39.363Z
- 近 30 天下载量：30110（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 2 个）

## 中文简介

一组严格的共享字型配置

## 安装

```sh
npm install @cprussin/tsconfig
```

也可以使用：`pnpm add @cprussin/tsconfig`、`yarn add @cprussin/tsconfig`、`bun add @cprussin/tsconfig`

## README

**@cprussin/tsconfig v5. 0**

* * *

# @cprussin/tsconfig v5. 0

此套件包含一组严格的共享打字配置.

# 安装

使用您选择的软件包管理器安装 :

-   **无**数字 : `npm install --save-dev @cprussin/tsconfig`
-   **小时**数字 : `pnpm add -D @cprussin/tsconfig`
-   **线条**数字 : `yarn add -D @cprussin/tsconfig`

这些配置不设置 `types` 数组, 因此环境 `@types/*` 软件包 (例如:. `@types/node`, (中文(简体) ), `@types/bun`, (中文(简体) ), `@types/jest`)不默认加载. 加入你需要的东西 `tsconfig.json`,例如:

```json
{
  "extends": "@cprussin/tsconfig/base.json",
  "compilerOptions": {
    "types": ["node"]
  }
}
```

# 使用量

添加您想要扩展到您的配置 `tsconfig.json`,例如:

```json
{
  "extends": "@cprussin/tsconfig/base.json"
}
```

请注意: `"noEmit": true` 由配置设置在此。 其意图是: 你用打字符检查并分发 未译出的文件,或者,如果你正在转出,那么转出 您正在使用的工具将覆盖在自己的配置中设置为 需要帮助。 举例来说,如果你在使用 `webpack`,您可以配置 `ts-loader` 像这样:

```js
{
  loader: "ts-loader",
  options: {
    compilerOptions: {
      sourceMap: process.env.NODE_ENV === "development",
      noEmit: false,
    },
  },
}
```

或者你可以有一个 `build` 您的脚本 `package.json` 运行 `tsc` 直接 :

```json
{
  "name": "foo",
  "scripts": {
    "build": "tsc --noEmit false --outDir ./dist"
  }
}
```

# 配置

## `base.json`

```jsonc
// tsconfig.json
{
  "extends": "@cprussin/tsconfig/base.json"
}
```

其他所有东西所延伸的基本配置. 设置一堆 严格选项,例如 `"strict": true`, (中文(简体) ), `"allowJs": false`, (中文(简体) ), `"noFallthroughCasesInSwitch": true`, (中文(简体) ), `"noImplicitReturns": true`等 (中文(简体) ). 若为 你想像我一样严格,你不会逐渐增加 键入到一个遗留项目中, 您可能不会想要覆盖大部分 这些选项,但也许可以推翻 `target` 或者说 `lib` 选项.

请注意,JSX或DOM库没有设置选项. 如果你需要的话 其中,你会想要使用 其中一个配置,延伸 `base.json` 而不是直接使用它.

## `dom.json`

```jsonc
// tsconfig.json
{
  "extends": "@cprussin/tsconfig/dom.json"
}
```

扩展 [`base.json`](https://npmcn.com/package/%40cprussin/tsconfig/#readme-md:basejson) 通过添加 `dom` 财务报告和审定财务报表 `dom.iterable` 利布尔斯.

## `react.json`

```jsonc
// tsconfig.json
{
  "extends": "@cprussin/tsconfig/react.json"
}
```

添加 `"jsx": "react-jsx"` 选项 [`dom.json`](https://npmcn.com/package/%40cprussin/tsconfig/#readme-md:domjson) 相会.

## `nextjs.json`

```jsonc
// tsconfig.json
{
  "extends": "@cprussin/tsconfig/nextjs.json"
}
```

添加 [下一个js 键入符 插件](https://beta.nextjs.org/docs/configuring/typescript#using-the-typescript-plugin) 页:1 [`react.json`](https://npmcn.com/package/%40cprussin/tsconfig/#readme-md:reactjson) 配置和开关 `jsx` 改为 `preserve` 和 `module`编号 :`moduleResolution` 用于基于捆绑工作流程.

## `webworker.json`

```jsonc
// tsconfig.json
{
  "extends": "@cprussin/tsconfig/webworker.json"
}
```

扩展 [`base.json`](https://npmcn.com/package/%40cprussin/tsconfig/#readme-md:basejson) 通过添加 `webworker` 莉比,别这样.

## 常见问题

### @cprussin/tsconfig 是什么？

一组严格的共享字型配置

### 如何安装 @cprussin/tsconfig？

在项目目录运行 npm install @cprussin/tsconfig，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^6\.0\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cprussin/tsconfig 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cprussin\_\_tsconfig 是否存在。

### @cprussin/tsconfig 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cprussin/tsconfig 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cprussin/tsconfig 可以商用吗？

@cprussin/tsconfig 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cprussin/tsconfig 的下载量有多少？

根据 npm 官方下载统计，@cprussin/tsconfig 在 2026/10/11 – 2026/11/09 这 30 天内被下载 30,110 次，日均约 1,004 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cprussin/tsconfig 还在维护吗？

最新版本 5\.0\.0 发布于 2026/04/23（6 个月前）；至今共发布 14 个版本，其中过去 12 个月发布了 2 个；首次发布于 2023/05/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。