{"record":{"id":"a00a2938201df152","repo":"astral-sh/uv","slug":"symlink-based-installation-is-not-supported-with","errorCode":null,"errorMessage":"Symlink-based installation is not supported with `--no-cache`. The created environment will be rendered unusable by the removal of the cache.","messagePattern":"Symlink-based installation is not supported with `--no-cache`\\. The created environment will be rendered unusable by the removal of the cache\\.","errorType":"validation","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"crates/uv-installer/src/installer.rs","lineNumber":100,"sourceCode":"        }\n    }\n\n    /// Install a set of wheels into a Python virtual environment.\n    #[instrument(skip_all, fields(num_wheels = %wheels.len()))]\n    pub async fn install(self, wheels: Vec<CachedDist>) -> Result<Vec<CachedDist>> {\n        let Self {\n            venv,\n            cache,\n            link_mode,\n            reporter,\n            name: installer_name,\n            metadata: installer_metadata,\n            preview,\n        } = self;\n\n        if cache.is_some_and(Cache::is_temporary) {\n            if link_mode.is_symlink() {\n                return Err(anyhow::anyhow!(\n                    \"Symlink-based installation is not supported with `--no-cache`. The created environment will be rendered unusable by the removal of the cache.\"\n                ));\n            }\n        }\n\n        let (tx, rx) = oneshot::channel();\n\n        let layout = venv.interpreter().layout();\n        let relocatable = venv.relocatable();\n        // Initialize the threadpool with the user settings.\n        initialize_rayon_once();\n        rayon::spawn(move || {\n            let result = install(\n                wheels,\n                &layout,\n                installer_name.as_deref(),\n                link_mode,\n                reporter.as_ref(),","sourceCodeStart":82,"sourceCodeEnd":118,"githubUrl":"https://github.com/astral-sh/uv/blob/f1a42680ff5272232d65748acf338b19778dde24/crates/uv-installer/src/installer.rs#L82-L118","documentation":"Error \"Symlink-based installation is not supported with `--no-cache`. The created environment will be rendered unusable by the removal of the cache.\" thrown in astral-sh/uv.","triggerScenarios":"Thrown at crates/uv-installer/src/installer.rs:100 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"f1a42680ff5272232d65748acf338b19778dde24","analyzedAt":"2026-08-16T04:51:47.599Z","schemaVersion":2},"datasetVersion":"2026-08-16T08:17:34.114Z"}