[FIX-007] Alias Path Resolution Failure (@/)

📝 Problem Background

Using import something from '@/components/...' in the code results in an error, stating the path cannot be resolved.

🧪 Effort Metrics

• Attempt Count: 1
• Time Spent: 10 min
• Complexity: ⭐⭐ (Normal)

🔍 Root Cause Analysis

Browser-native ES Modules do not support non-standard prefixes like @/. This requires synchronized configuration between the build tool (Vite) and the language analysis tool (TypeScript).

🛠️ Fix Strategy

Config Sync Protocol:

1. Vite Config: Add resolve.alias in vite.config.ts, physically mapping @ to path.resolve(__dirname, './').
2. TS Config: Synchronously add "@/*": ["*"] to compilerOptions.paths in tsconfig.json.

---

Note: This is an engineering fundamental for maintaining clean imports.