tj-actions/changed-files 使用指南

最新推荐文章于 2025-05-22 23:49:05 发布

虞怀灏Larina

最新推荐文章于 2025-05-22 23:49:05 发布

阅读量587

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00548/article/details/142475193

版权

tj-actions/changed-files 使用指南

changed-files :octocat: Github action to retrieve all (added, copied, modified, deleted, renamed, type changed, unmerged, unknown) files and directories. 项目地址: https://gitcode.com/gh_mirrors/ch/changed-files

本指南将详细介绍开源项目 tj-actions/changed-files，它是一个GitHub Actions，用于检索相对于目标分支或当前分支（前一次提交或最后一个远程提交）、多个分支或自定义提交的所有更改过的文件和目录。

1. 项目目录结构及介绍

项目遵循标准的GitHub仓库结构，其主要目录和文件简要说明如下：

根目录:
- action.yml: GitHub Action的配置文件，定义了Action的工作流参数和运行逻辑。
- CODE_OF_CONDUCT.md, CONTRIBUTING.md, LICENSE, README.md, SECURITY.md: 开源项目的标准文件，分别介绍了代码规范、贡献指南、许可证信息、项目简介和安全相关事项。
- src 和 test: 分别包含了源代码和测试代码，确保Action的正确执行。
- jest.config.js: Jest测试框架的配置文件。
- package.json, yarn.lock: Node.js项目的元数据和依赖管理文件。
- prettierrc.json, .eslintignore, .gitignore: 代码风格检查和版本控制忽略规则配置。
- renovate.json: 自动化更新依赖的配置文件。
配置和脚本:
- 不存在传统意义上的单一“启动文件”，因为这是一个在GitHub工作流中使用的Action。但是，配置样例通常位于.github/workflows目录下，由用户根据需求定制。

2. 项目的启动流程（非直接启动，集成于GitHub Workflows）

由于这是一个GitHub Action，它不以传统的应用程序形式启动。而是通过GitHub的工作流yaml文件集成并触发。典型的“启动”步骤是在.github/workflows目录下创建一个新的YAML文件，然后在这个文件中调用tj-actions/changed-files Action，并设置必要的参数。例如：

on: [push, pull_request]
jobs:
  changed-files-job:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: tj-actions/changed-files@v45
        with:
          files: |
            **/*.md
          since_last_remote_commit: true

这里的YAML脚本定义了一个监听push和pull_request事件的作业，使用actions/checkout获取代码，接着调用tj-actions/changed-files来检测指定类型的文件变化情况。