如果在部署或持續開發期間，您遇到以下形式的錯誤：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 未沿用殼層環境變數的問題。當 PATH 變數在 .bash_profile 或 .bash_rc 中定義，且 IDE 從 GUI 啟動時，某些 Linux 環境就會發生這個問題，造成 IDE 無法查看 PATH 變數。
如要解決這個問題，請在 IDE 中使用 Cloud Code 設定，允許 Cloud Code 自動管理 gcloud CLI 和 Kubernetes 依附元件的更新 (依序點選「File」 >「Settings」 >「Tools」 >「Cloud Code」 >「Kubernetes」；如果是 Mac OS X，請依序點選「IntelliJ IDEA」 >「Preferences」 >「Tools」 >「Cloud Code」 >「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"]],["上次更新時間：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."]]
