Skip to main content
版本: 0.8

安装问题

MacOS 提示无法打开 "kcl"，因为 Apple 无法检查其是否包含恶意软件​

MacOS 提示无法打开 "kcl"，因为 Apple 无法检查其是否包含恶意软件。这个错误是因为 macOS 操作系统中的 Gatekeeper 安全功能阻止了应用程序的运行。要解决此问题，请按照以下步骤操作：

打开"系统偏好设置"并点击"安全性与隐私"。 在"通用"选项卡中，您将看到一个消息："kcl" 已被阻止。单击"仍要打开"。 或者，你可以单击"打开任何方式"以打开你的应用程序。（可能需要使用管理员权限来打开应用程序。）

如果不想在每次打开应用程序时都执行这些步骤，则可以的应用程序添加到白名单中，以便在不受阻止的情况下运行。要将您的应用程序添加到白名单中，请执行以下操作：

打开终端并输入以下命令：

xattr -d com.apple.quarantine /path/to/kcl

其中，/path/to/kcl 是 kcl 应用程序的完整路径。运行命令后，应用程序将被添加到白名单中，Gatekeeper 将不再阻止其运行。

在 Windows/Linux/MacOS 平台上报 program not found 或者 run linker failed 错误​

请确保如下依赖在您的 PATH 中

  • MacOS: clang
  • Linux: gcc
  • Windows: cl.exe (可以通过安装 MSVC 获得，主要包括 MSVCP140.dll 和 VCRUNTIME140.dll 等程序集)

在 Windows 平台上遇到 exit status 0xc0000135 错误​

请确保您的 Windows 上安装了 .NET Framework 和 MSVC，如没有安装，可以安装并重试。

在容器中启动/运行 KCL 报没有权限或者找不到文件的错误​

这是因为 KCL 在编译时的默认全局配置和全局包缓存需要写入权限，一种解决方式是将全局配置和包目录设置到 /tmp 文件夹，详见这里 的 Dockerfile 配置

ENV KCL_PKG_PATH=/tmp
ENV KCL_CACHE_PATH=/tmp

在 MacOS 出现错误 docker-credential-desktop: executable file not found in $PATH​

KCL 的包管理工具底层借助 docker 提供的三方库完成与 OCI Registry 的交互，会产生配置文件 ~/.docker/config.json，这个错误通常发生在从 Docker Desktop 切换到 Podman，而本地没有安装 Docker 的情况下。该文件会被用于在对 BuildKit 进行身份验证的调用中读取。要解决此问题，请尝试删除或重命名 ~/.docker/config.json 文件。

更多关于该错误的详细信息：https://docs.earthly.dev/docs/guides/podman#mac-docker-credential-desktop-executable-file-not-found-in-usdpath