diff --git a/dist/setup/index.js b/dist/setup/index.js
index c2158733..7f7400d6 100644
--- a/dist/setup/index.js
+++ b/dist/setup/index.js
@@ -98907,6 +98907,9 @@ class PipCache extends cache_distributor_1.default {
                     ({ stdout, stderr } = yield execPromisify('pip cache dir'));
                 }
                 catch (err) {
+                    // Pip outputs warnings to stderr (e.g., --no-python-version-warning flag deprecation warning), causing false failure detection
+                    // Related issue: https://github.com/actions/setup-python/issues/1034
+                    // If an error occurs, set exitCode to 1 to indicate failure
                     exitCode = 1;
                 }
             }
diff --git a/src/cache-distributions/pip-cache.ts b/src/cache-distributions/pip-cache.ts
index 1833c5f2..4af492c0 100644
--- a/src/cache-distributions/pip-cache.ts
+++ b/src/cache-distributions/pip-cache.ts
@@ -35,6 +35,9 @@ class PipCache extends CacheDistributor {
       try {
         ({stdout, stderr} = await execPromisify('pip cache dir'));
       } catch (err) {
+        // Pip outputs warnings to stderr (e.g., --no-python-version-warning flag deprecation warning), causing false failure detection
+        // Related issue: https://github.com/actions/setup-python/issues/1034
+        // If an error occurs, set exitCode to 1 to indicate failure
         exitCode = 1;
       }
     } else {