Akamai Pipeline Save无法写入dist目录，除权限外还有哪些排查方向？

• 检查项目路径是否存在
  确认myProject对应的文件夹真实存在且拼写无误。Akamai CLI执行时会先读取项目配置文件，路径错误会直接触发找不到文件的报错。可以先运行ls查看当前目录下的文件夹，或者用绝对路径指定项目（比如akamai pipeline save -p /Users/xxx/myProject test）测试。

• 验证Pipeline配置文件完整性
  项目根目录必须存在pipeline.json配置文件，且结构符合Akamai Pipeline要求。如果文件缺失、文件名拼写错误（比如写成pipeline.config），或者文件内source/target等字段指向不存在的路径，CLI读取配置时会抛出ENOENT错误。直接打开pipeline.json检查这些路径是否真实存在即可。

• 确认当前工作目录是否正确
  别默认自己在项目父目录，实际可能跑错了路径。用pwd查看当前所在目录，确保myProject是当前目录的子文件夹，或者切换到正确目录后再执行命令。

• 检查Akamai CLI和插件版本
  旧版本的CLI或Pipeline插件可能存在路径处理bug，导致无法创建dist目录。运行akamai --version查看CLI版本，akamai pipeline --version查看插件版本，对比官方要求判断是否需要更新。更新命令：akamai update（更新CLI）、akamai install pipeline（重装插件）。

• 深挖文件系统权限细节
  除了iTerm的写入权限，还要检查项目目录本身的权限：

  • 运行ls -ld myProject查看目录的所有者和权限，确保当前用户有读写权限（权限位至少是rwx或rw-）。
  • 如果目录由root或其他用户创建，用chown -R $(whoami) myProject修改为当前用户所有，或者chmod -R 755 myProject调整权限。
  • MacOS的系统完整性保护（SIP）会限制/System、/Library等目录的写入，别把项目放在这些受保护路径下。

• 测试简化命令场景
  先去掉test参数，用基础命令akamai pipeline save -p myProject测试是否能正常生成dist目录。如果基础命令正常，说明test对应的环境配置有问题，去pipeline.json里检查与test相关的路径设置。

• 开启调试模式查看详细日志
  添加--debug参数执行命令：akamai --debug pipeline save -p myProject test，调试日志会显示CLI尝试访问的具体文件路径，能精准定位到底是哪个路径不存在。

内容的提问来源于stack exchange，提问作者Divide by Zero