# @atlassian/i18n-properties-loader 中文文档

规范地址：https://npmcn.com/package/%40atlassian/i18n-properties-loader/

版本：2\.1\.0
npm 元数据更新时间：2026-07-22T09:45:12.570Z
中文译文更新时间：2026-11-08T07:29:38.800Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40atlassian/i18n-properties-loader
原文对照：https://npmcn.com/package/%40atlassian/i18n-properties-loader/?lang=original
项目主页：https://bitbucket.org/atlassianlabs/fe-server
源码仓库：https://bitbucket.org/atlassianlabs/fe-server

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

- 包体积（解压后）：31.1 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=12
- 运行依赖：4 个
- peer 依赖：@rspack/core ^1\.0\.0 \|\| ^2\.0\.0-0，webpack ^5\.0\.0
- 首次发布：2019-04-02T05:57:26.816Z
- 最新版本发布：2026-07-22T09:45:12.379Z
- 近 30 天下载量：1870（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：58（近 12 个月 13 个）

## 中文简介

I18n \*. propertys 文件的网络装入器,可用于Atlassian 服务器产品

## 安装

```sh
npm install @atlassian/i18n-properties-loader
```

也可以使用：`pnpm add @atlassian/i18n-properties-loader`、`yarn add @atlassian/i18n-properties-loader`、`bun add @atlassian/i18n-properties-loader`

## README

# @atlassian/i18n 财产装入器

![node version](https://img.shields.io/node/v/@atlassian/i18n-properties-loader.svg) ![npm downloads](https://img.shields.io/npm/dt/@atlassian/i18n-properties-loader.svg)

I18n 装入器 `*.properties` 在 Atlassian 服务器产品和插件中可以使用网络包装或rspack的文件.

## 动机

如果你在现代前端服务器代码上的工作 很有可能你已经在使用 [阿特拉斯网络资源网络包插件](https://www.npmjs.com/package/atlassian-webresource-webpack-plugin)。 。 。 . 如果您真的配置了您的网页软件包来使用开发服务器, 您可能会丢失显示正确的翻译短语 现在.

这个 `@atlassian/i18n-properties-loader` 可以帮助你解决这个问题。 这是一个网络包装装填器 允许你 在您的开发工作流程中显示翻译短语,同时使用WRM.

关于翻译系统的更多信息,请查看阿特拉斯发展文件页:

-   [正在国际化您的插件](https://developer.atlassian.com/server/framework/atlassian-sdk/internationalising-your-plugin/)

## 安装

```sh
npm install @atlassian/i18n-properties-loader --save-dev
```

## 用法实例

```js
// webpack.config.js

const myI18nFiles = [
  'foo/i18n/my-translation-file.properties',
  'foo/bar/i18n/my-other-translation-file.properties',
  'bar/i18n/some-translation-file.properties',
];

module.exports = {
  module: {
    rules: [
      {
        test: /\.jsx?$/,
        include: ['src'],

        use: [
          {
            loader: '@atlassian/i18n-properties-loader',
            options: {
              i18nFiles: myI18nFiles,
            },
          },

          {
            loader: 'babel-loader',
          },
        ],
      },
    ],
  },
};
```

## 选项

-   `i18nFiles` 路径列表 `*.properties` 文件( 需要)
-   `disabled` 禁用装入器; 是否用于禁用生产捆绑( 可选, 默认) `false`(中文(简体) )

### 创建生产捆绑

装载机仅在开发模式下需要. 你应该记得,当您在生产捆绑时, 把它禁用.

用网络包装及其 [`mode` 配置](https://webpack.js.org/configuration/mode/) 您可以截取您网络包装配置中当前选择的模式, 并禁用装入器 :

```js
// webpack.config.js

module.exports = (env, argv) => {
  const isDevelopmentMode = argv.mode === 'development'; // 1. Check if we are running webpack in "development" mode

  return {
    module: {
      rules: [
        {
          test: /\.jsx?$/,
          include: ['src'],

          use: [
            {
              loader: '@atlassian/i18n-properties-loader',
              options: {
                i18nFiles,
                disabled: !isDevelopmentMode, // 2. Skip and disable loader when webpack is running in "production" mode
              },
            },

            {
              loader: 'babel-loader',
            },
          ],
        },
      ],
    },
  };
};
```

## 反应 i18n 帮助器

这个套件很适合 [`@atlassian/wrm-react-i18n`](https://www.npmjs.com/package/@atlassian/wrm-react-i18n) 当您想要使用时 `I18n.getText()` 带有 React 组件的翻译助手.

您可以检查软件包描述的更多细节,并学习如何将其与你的网络包配置相融合.

## 其他链接

-   [https://www.npmjs.com/package/@atlassian/i18n-properties-loader (英语)](https://www.npmjs.com/package/@atlassian/i18n-properties-loader)
-   [https://www.npmjs.com/package/@atlassian/wrm-react-i18n (英语)](https://www.npmjs.com/package/@atlassian/wrm-react-i18n)
-   [https://www.npmjs.com/package/atlassian-webresources-webpack-plugin (中文(简体) )](https://www.npmjs.com/package/atlassian-webresource-webpack-plugin)

## 最低要求

此插件兼容 :

-   网包5,或 rspack 1 或 2
-   节点12+

## 常见问题

### @atlassian/i18n-properties-loader 是什么？

I18n \*\. propertys 文件的网络装入器,可用于Atlassian 服务器产品

### 如何安装 @atlassian/i18n-properties-loader？

在项目目录运行 npm install @atlassian/i18n-properties-loader，或使用 pnpm add / yarn add / bun add。

### @atlassian/i18n-properties-loader 支持 TypeScript 吗？

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

### @atlassian/i18n-properties-loader 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @atlassian/i18n-properties-loader 需要什么版本的 Node\.js？

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

### @atlassian/i18n-properties-loader 可以商用吗？

@atlassian/i18n-properties-loader 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @atlassian/i18n-properties-loader 的下载量有多少？

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

### @atlassian/i18n-properties-loader 还在维护吗？

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