GitHub Actions 中的工作目录设置：你需要知道的“working-directory cannot be used with uses with”

在使用GitHub Actions进行自动化工作流时，working-directory是一个常用的配置项，用于指定工作流步骤的执行目录。然而，有一个常见的误区是将working-directory与uses with混合使用。今天我们就来详细探讨一下working-directory cannot be used with uses with，以及如何正确地配置工作目录。

什么是 working-directory？

在GitHub Actions中，working-directory是一个步骤级别的配置项，用于指定该步骤执行时所在的目录。例如：

- name: Run a script
  run: ./my-script.sh
  working-directory: ./scripts

上面的配置会让my-script.sh在./scripts目录下执行。

为什么不能与 uses with 一起使用？

uses with是用于指定复用其他工作流或操作的输入参数的。当你使用uses关键字时，实际上是在调用一个预定义的操作或工作流，这些操作或工作流可能有自己的工作目录设置。如果你尝试在uses中使用working-directory，可能会导致冲突或错误，因为这些操作可能已经预设了自己的工作目录。

例如：

- name: Use an action
  uses: some/action@v1
  with:
    working-directory: ./my-dir # 这会导致错误

这种配置是不正确的，因为some/action@v1可能已经定义了自己的工作目录，强行指定可能会导致操作无法正常执行。

正确使用 working-directory 的方法

如果你需要在使用外部操作时改变工作目录，有几种方法可以实现：

在操作之前改变目录：

- name: Change directory
  run: cd ./my-dir && some-action

使用 shell 脚本：

- name: Run script in specific directory
  run: |
    cd ./my-dir
    some-action

使用自定义操作：如果你经常需要在特定目录下执行操作，可以创建一个自定义操作，专门处理目录切换。

应用场景

构建和测试：在不同的目录下运行构建脚本或测试脚本。
部署：在特定目录下执行部署脚本。
代码质量检查：在代码库的不同部分运行代码质量检查工具。

注意事项

确保路径正确：确保指定的工作目录路径是正确的，避免路径错误导致的失败。
权限问题：某些操作可能需要特定的权限才能在指定目录下执行。
环境变量：有时需要设置环境变量来辅助工作目录的切换。

总结

在GitHub Actions中，working-directory是一个强大的工具，但需要正确使用。记住，working-directory cannot be used with uses with，这是因为外部操作可能已经预设了自己的工作目录。通过理解这些限制和使用替代方法，你可以更灵活地管理工作流中的目录设置，从而提高自动化任务的效率和准确性。

希望这篇文章能帮助你更好地理解和应用GitHub Actions中的工作目录设置，避免常见的配置错误，提升你的工作流管理水平。