update faq

This commit is contained in:
Tw93
2025-11-16 19:56:17 +08:00
parent b4b84bd6fd
commit 5ac01d0f4a
4 changed files with 102 additions and 2 deletions

50
docs/faq.md vendored
View File

@@ -6,6 +6,56 @@ Common issues and solutions when using Pake.
## Build Issues
### Rust Version Error: "feature 'edition2024' is required"
**Problem:**
When building Pake or using the CLI, you encounter an error like:
```txt
error: failed to parse manifest
Caused by:
feature `edition2024` is required
this Cargo does not support nightly features, but if you switch to nightly channel you can add `cargo-features = ["edition2024"]`
to enable this feature
```
**Why This Happens:**
Pake's dependencies require Rust edition2024 support, which is only available in Rust 1.85.0 or later. Specifically:
- The dependency chain includes: `tauri``image``moxcms``pxfm v0.1.25` (requires edition2024)
- Rust edition2024 became stable in Rust 1.85.0 (released February 2025)
- If your Rust version is older (e.g., 1.82.0 from August 2024), you'll see this error
**Solution:**
Update your Rust toolchain to version 1.85.0 or later:
```bash
# Update to the latest stable Rust version
rustup update stable
# Or install the latest stable version
rustup install stable
# Verify the update
rustc --version
# Should show: rustc 1.85.0 or higher
```
After updating, retry your build command.
**For Development Setup:**
If you're setting up a development environment, ensure:
- Rust ≥1.85.0 (check with `rustc --version`)
- Node.js ≥22.0.0 (check with `node --version`)
See [CONTRIBUTING.md](../CONTRIBUTING.md) for complete prerequisites.
---
### Windows: Installation Timeout During First Build
**Problem:**