如果您在部署或持续开发期间遇到 executable file not found in $PATH 形式的错误,
例如:
time="2018-11-01T12:46:38-04:00" level=fatal msg="exiting dev mode because the first build failed: building [gcr.io//my-proj]: tagging: pushing: getting auth config for gcr.io//my-proj:3c275201-dirty-50f870d: getting auth config: error getting credentials - err: exec: "docker-credential-gcr": executable file not found in $PATH, out: ``"
那么,您可能遇到了 IDE 未继承 shell 环境变量的问题。在某些 Linux 环境中,如果 PATH 变量在 .bash_profile 或 .bash_rc 中定义,而 IDE 从 GUI 启动,则会导致 IDE 无法看到 PATH 变量,进而发生这种情况。
您可以在 IDE 中使用 Cloud Code 设置(File > Settings > Tools > Cloud Code > Kubernetes;对于 Mac OS X,则为 IntelliJ IDEA > Preferences > Tools > Cloud Code > Kubernetes),允许 Cloud Code 自动管理对 gcloud CLI 和 Kubernetes 依赖项的更新,从而解决此问题。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-04。"],[[["\u003cp\u003eThe "executable file not found in $PATH" error often occurs when an IDE launched from a GUI doesn't inherit shell environment variables.\u003c/p\u003e\n"],["\u003cp\u003eThis issue can be resolved by letting Cloud Code automatically manage updates to gcloud CLI and Kubernetes dependencies within the IDE settings.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, launching the IDE from the terminal using its command-line launcher can resolve the issue by ensuring the IDE uses the current environment variables.\u003c/p\u003e\n"],["\u003cp\u003eAnother method is to set the PATH variables in a system-wide location, such as \u003ccode\u003e/etc/environment\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot common installation issues in Cloud Code for IntelliJ\n\nHow do I fix 'executable not found on PATH' errors?\n---------------------------------------------------\n\nIf, during deployment or continuous development, you are getting errors in the\nform of `executable file not found in $PATH`.\n\nFor example: \n\n```\ntime=\"2018-11-01T12:46:38-04:00\" level=fatal msg=\"exiting dev mode because the first build failed: building [gcr.io//my-proj]: tagging: pushing: getting auth config for gcr.io//my-proj:3c275201-dirty-50f870d: getting auth config: error getting credentials - err: exec: \"docker-credential-gcr\": executable file not found in $PATH, out: ``\"\n```\n\n\u003cbr /\u003e\n\nThen, you may be running into the problem where the IDE is not inheriting the\nshell environment variables. This can happen in some Linux environments when\nthe `PATH` variables are defined in `.bash_profile` or `.bash_rc` and the\nIDE is launched from the GUI, causing the IDE not to see the `PATH` variables.\n\nThis can be solved by allowing Cloud Code to automatically manage\nupdates to gcloud CLI and Kubernetes dependencies, using the Cloud Code\nsettings within your IDE (**File** \\\u003e **Settings** \\\u003e **Tools** \\\u003e **Cloud Code** \\\u003e\n**Kubernetes** or for Mac OS X, **IntelliJ IDEA** \\\u003e\n**Preferences** \\\u003e **Tools** \\\u003e **Cloud Code** \\\u003e **Kubernetes**).\n\nIf you'd like to maintain custom versions of these dependencies, you can\nsolve this issue in Linux using the following workaround:\n\n- Launch the IDE from the terminal\n\n First, follow these instructions to enable a command-line launcher. Then\n launch the IDE from the terminal.\n\n For example, to launch IntelliJ IDEA from the terminal, navigate to\n the project you wish to open, then execute: \n\n idea .\n\n Similarly, to launch PyCharm, execute: \n\n charm .\n\n- Alternatively, set the `PATH` variables in a system-wide location such\n as /etc/environment.\n\nDiagnosing and reporting an issue\n---------------------------------\n\nIf your issue isn't covered in this doc, try finding a resolution to the issue\nby:\n\n- Searching the [Cloud Code for IntelliJ GitHub issues](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues?q=is%3Aissue+)\n and/or [StackOverflow](https://stackoverflow.com/search?q=%5Bgoogle-cloud-code%5D)\n for a similar problem\n\n- Joining the [`#cloud-code`](https://googlecloud-community.slack.com/messages/cloud-code/)\n channel, which is part of the [Google Cloud Slack community](https://join.slack.com/t/googlecloud-community/shared_invite/zt-2mz6i6j8l-qMC13DEg6FAtGMH4wVytTA),\n and asking about the issue, where one of the community members may be able to\n identify the problem\n\nIf you couldn't resolve the issue after trying to diagnose it, then you can\nreport the issue in the IntelliJ IDE:\n\n1. Click **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit feedback or\n report an issue**. This prompts you to report an issue on GitHub.\n\n2. Follow the template in the issue reporting box to describe the issue."]]