@actions/io

中文文档
3.0.2发布于 2026/01/29MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 5925.1万

Actions io lib

原始使用文档

@actions/io

Core functions for cli filesystem scenarios

Usage

mkdir -p

Recursively make a directory. Follows rules specified in man mkdir with the -p option specified:

const io = require('@actions/io');

await io.mkdirP('path/to/make');

cp/mv

Copy or move files or folders. Follows rules specified in man cp and man mv:

const io = require('@actions/io');

// Recursive must be true for directories
const options = { recursive: true, force: false }

await io.cp('path/to/directory', 'path/to/dest', options);
await io.mv('path/to/file', 'path/to/dest');

rm -rf

Remove a file or folder recursively. Follows rules specified in man rm with the -r and -f rules specified.

const io = require('@actions/io');

await io.rmRF('path/to/directory');
await io.rmRF('path/to/file');

which

Get the path to a tool and resolves via paths. Follows the rules specified in man which.

const exec = require('@actions/exec');
const io = require('@actions/io');

const pythonPath: string = await io.which('python', true)

await exec.exec(`"${pythonPath}"`, ['main.py']);

版本与发布记录

@actions/io 共发布 11 个版本,首次发布于 2019/08/08;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.0.2latest2026/01/299 个月前
3.0.12026/01/299 个月前
3.0.02026/01/299 个月前
2.0.02025/10/311 年前
1.1.32023/03/163 年前
1.1.22022/03/184 年前

关于 @actions/io 的常见问题

@actions/io 是什么?

Actions io lib

如何安装 @actions/io?

在项目目录运行 npm install @actions/io,或使用 pnpm add / yarn add / bun add。

@actions/io 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@actions/io 支持 ESM 还是 CommonJS?

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

@actions/io 可以商用吗?

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

@actions/io 的下载量有多少?

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

@actions/io 还在维护吗?

最新版本 3.0.2 发布于 2026/01/29(9 个月前);至今共发布 11 个版本,其中过去 12 个月发布了 3 个;首次发布于 2019/08/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。