| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
一个实用的工具类库，提供丰富的工具函数，帮助开发者提高开发效率。
# 使用 npm
npm install @winner-fed/cloud-utils
# 使用 yarn
yarn add @winner-fed/cloud-utils
# 使用 pnpm
pnpm add @winner-fed/cloud-utilsimport { formatDate, accAdd, isEmpty } from '@winner-fed/cloud-utils';
// 使用日期格式化
const formattedDate = formatDate(new Date(), 'YYYY-MM-DD');
// 使用精确加法
const sum = accAdd(0.1, 0.2); // 0.3
// 判断是否为空
const empty = isEmpty(null); // true使用主入口 @winner-fed/cloud-utils 会解析整包（含 idCard、decimal.js 等），打包时会把相关依赖（如 idcard）一并打进产物。若只需少量函数（例如只要 formatDate），请用子路径按需引入，避免打入未使用的依赖：
对于只需要少数几个函数的场景，可以直接导入独立函数，减少打包体积：
// ESM 格式 - 自动选择合适的文件
import { accAdd } from '@winner-fed/cloud-utils/accAdd';
import { formatDate } from '@winner-fed/cloud-utils/formatDate';
import { isEmpty } from '@winner-fed/cloud-utils/isEmpty';
// CommonJS 格式
const { accAdd } = require('@winner-fed/cloud-utils/accAdd');
const { formatDate } = require('@winner-fed/cloud-utils/formatDate');如果需要明确指定导入格式：
// 明确使用 ESM 格式
import { accAdd } from '@winner-fed/cloud-utils/dist/esm/accAdd.js';
// 明确使用 CommonJS 格式
const { accAdd } = require('@winner-fed/cloud-utils/dist/cjs/accAdd.js');import * as utils from '@winner-fed/cloud-utils';
// 使用工具函数
const result = utils.formatDate(new Date(), 'YYYY-MM-DD');
const sum = utils.accAdd(0.1, 0.2);本包提供了多种格式以适应不同的使用场景：
@winner-fed/cloud-utils/ ├── dist/ │ ├── index.js # ESM 主入口 │ ├── index.cjs # CommonJS 主入口 │ ├── index.d.ts # TypeScript 声明文件 │ ├── *.d.ts # 独立函数的声明文件 │ ├── esm/ # ESM 格式的独立函数 │ │ ├── accAdd.js │ │ ├── formatDate.js │ │ └── ... │ ├── cjs/ # CommonJS 格式的独立函数 │ │ ├── accAdd.js │ │ ├── formatDate.js │ │ └── ... │ └── umd/ # UMD 格式（浏览器直接使用） │ └── index.js
<!-- 通过 CDN 引入 UMD 格式 -->
<script src="https://unpkg.com/@winner-fed/cloud-utils/dist/umd/index.js"></script>
<script>
// 全局变量 cloudUtils
const result = cloudUtils.formatDate(new Date(), 'YYYY-MM-DD');
const sum = cloudUtils.accAdd(0.1, 0.2);
</script>不同的导入方式适用于不同的使用场景：
| 导入方式 | 包体积 | 适用场景 | 示例 |
|---|---|---|---|
| 完整引入 | 整包较大（含 idcard、decimal.js 等依赖） | 使用多个函数时 | import { a, b, c } from '@winner-fed/cloud-utils' |
| 独立函数导入 | ~1-3KB/函数 | 只使用少数函数时推荐 | import { accAdd } from '@winner-fed/cloud-utils/accAdd' |
| 直接路径导入 | ~1-3KB/函数 | 明确指定格式时 | import { accAdd } from '@winner-fed/cloud-utils/dist/esm/accAdd.js' |
# 安装依赖
pnpm install
# 开发模式
pnpm dev
# 构建
pnpm build
# 测试
pnpm test
# 文档开发
pnpm docs:dev
# 文档构建
pnpm docs:build欢迎提交 Issue 和 Pull Request。
| Back | FazBrowse Home | New Git URL |