Fix npm run build Failed on macOS: Common Causes and Solutions - Virtual Environment Not Activating: Quick Fix-Resolving 'index.lock File Exists' in Git

Prepare
Execute
Validate
Document
Operational follow-up
- Record the exact option, command, or setting that changed the result.
- Keep a rollback note if the workflow affects shared files or team settings.