micra是做什么用的？
micra是一款轻量级的命令行工具，主要用于快速搭建和管理微型前端项目。它的核心设计目标是减少配置时间，让开发者能在一分钟内启动一个包含热更新、路由和状态管理的基础框架。与大型脚手架不同，micra不强制绑定特定UI库，而是通过插件机制支持React、Vue或原生JavaScript，适合用来做组件原型、内部工具页或教学演示。它的“微型”体现在安装包体积小于2MB，且不依赖重型构建链，但依然能输出生产可用的压缩代码。
# micra和Vite、Create React App有什么区别？
主要区别在于定位和依赖范围。Vite是一个通用的构建引擎，侧重于开发服务器性能和原生ES模块支持；Create React App（CRA）则是React生态的完整解决方案，自带大量配置。micra则介于两者之间，它更像一个“配置生成器”——安装后自动生成一个精简的vite.config.js和入口文件，但去掉了CRA中不必要的测试、PWA等模块。如果你只需要一个能跑起来的空项目，micra比Vite更快（因为省去手动建文件），比CRA更轻（没有额外依赖）。但如果你需要深度定制构建流程，micra的默认配置反而可能成为限制。
# micra的安装步骤是什么？
安装micra需要Node.js 16.0以上版本。全局安装命令是`npm install -g micra-cli`，或者使用npx直接运行：`npx micra create my-app`。安装完成后，进入项目目录执行`npm install`安装依赖，然后运行`npm run dev`即可启动开发服务器。注意，micra不会自动安装你选择的UI框架，需要在创建时通过`--react`或`--vue`参数指定，否则默认生成纯JavaScript模板。如果你遇到权限错误（如EACCES），建议在命令前加`sudo`（仅限macOS/Linux）或检查npm全局目录权限。
# micra支持哪些框架和模板？
当前micra官方支持三种模板：原生JavaScript（带ESM语法）、React 18（使用函数组件和hooks）、Vue 3（使用组合式API）。通过`--template`参数可以指定，例如`npx micra create app --template vue`。此外，micra还允许你通过`--plugin`标志加载社区插件，比如`@micra/plugin-tailwind`能自动集成Tailwind CSS。但要注意，插件不是官方维护的，版本兼容性需自行验证。如果你需要TypeScript支持，目前需要手动添加`typescript`依赖并创建tsconfig.json，micra不会自动生成类型配置。
# 使用micra时常见的报错和解决方法有哪些？
第一类报错是`Cannot find module 'micra/config'`，这通常是因为在项目根目录缺少`micra.config.js`文件。解决方法是运行`npx micra init`生成默认配置，或者手动创建文件并导出空对象。第二类是热更新失效（修改代码页面不刷新），检查是否在`vite.config.js`中设置了`server.hmr`为false，或者防火墙阻止了默认的3000端口。第三类是构建时出现`UnhandledPromiseRejection`，这多半是因为内存不足，在`package.json`的build脚本中增加`NODE_OPTIONS=--max-old-space-size=2048`。如果遇到安装依赖时卡住，可以切换npm镜像源到`https://registry.npmmirror.com`。
# micra适合用于生产环境吗？
这取决于项目规模。micra生成的默认构建配置只包含基础代码分割和压缩，没有内置代码混淆、资源指纹或CDN上传功能。对于内部管理系统、快速原型或活动页，完全可以直接部署到静态服务器（如Nginx或Netlify）。但如果是高流量商业站点，建议将micra仅作为开发启动器，然后手动补充以下内容：在`vite.config.js`中开启`build.rollupOptions.output.manualChunks`来优化分包，添加`.env.production`环境变量，以及配置`publicPath`为你的CDN域名。另外，micra的更新频率较低（约每季度一次），长期维护需关注其GitHub仓库的issue动态。
# 如何将现有项目迁移到micra？
迁移分为两种情况。如果你是从CRA迁移，需要先删除`react-scripts`相关依赖，然后运行`npx micra init`生成新配置文件，最后将`src/index.js`的入口改为`src/main.jsx`（React）或`src/main.js`（Vue），并调整HTML文件中的脚本引用路径。如果你是从纯HTML+JS迁移，只需把静态文件放入`public`目录，并在`index.html`中引入模块脚本即可。迁移后要特别注意环境变量：CRA使用`REACT_APP_`前缀，而micra使用`VITE_`前缀，需要批量替换。建议迁移前先备份原项目，并在Git分支中测试构建结果。
# micra的配置项有哪些值得关注的？
`micra.config.js`支持几个关键配置项。`server.port`用于修改开发端口，默认是3000。`build.target`可以设为`es2018`或`es2020`，影响输出代码的兼容性。`plugins`数组允许加载自定义Vite插件，例如`vite-plugin-html`可以多页面入口。另外，`resolve.alias`能设置路径别名，比如将`@`指向`src`目录，这样在深层文件中导入会更简洁。最常用的是`build.outDir`，默认是`dist`，可以改为`build`或`public_html`来适配不同服务器的部署路径。注意，修改配置文件后必须重启`npm run dev`才会生效，且micra不支持热更新配置文件本身。