Electron 应用打包实战：从 electron-builder.yml 配置到多平台部署
1. 理解 electron-builder.yml 的核心配置
第一次接触 electron-builder.yml 时，我也被那一大堆配置项搞得头晕眼花。但后来发现，只要掌握几个关键配置，就能解决80%的打包问题。这个文件就像是Electron应用的"打包说明书"，告诉构建工具如何处理你的应用。
最基础的配置莫过于appId和productName。appId相当于你应用的身份证号，必须是全球唯一的。我习惯用反向域名命名法，比如com.mycompany.myapp。而productName就是用户看到的名称，比如"微信"、"钉钉"这样的显示名称。
directories.buildResources这个配置特别实用。我通常在这里放应用图标、证书等资源文件。记得有一次打包时图标总是显示不出来，折腾半天才发现是路径配置错了。正确的做法是把图标文件放在这个目录下，然后在配置中引用。
directories: buildResources: resourcesfiles配置项决定了哪些文件会被打包进最终的应用。新手常犯的错误是把所有源代码都打包进去，导致安装包特别大。实际上只需要打包构建后的文件即可。我常用的排除模式是这样的：
files: - '!**/node_modules/*' - '!**/.git/*' - '!**/test/*'2. 搞定Windows平台打包配置
Windows平台的打包是最复杂的，但也是最重要的。win.executableName决定了生成的可执行文件名称。我建议用英文且不带空格，比如myapp而不是 "我的应用"。
NSIS配置是Windows打包的核心。artifactName控制生成的安装包文件名，我习惯加上版本号方便管理：
win: nsis: artifactName: 'MyApp-${version}-Setup.${ext}'allowToChangeInstallationDirectory这个选项特别重要。设为true可以让用户选择安装路径，避免强制安装到C盘的尴尬。而perMachine则决定是为当前用户还是所有用户安装。
桌面快捷方式的配置也很有讲究。我遇到过用户反馈找不到应用的情况，后来发现是忘了配置快捷方式：
win: nsis: createDesktopShortcut: always createStartMenuShortcut: true3. macOS平台打包的注意事项
macOS打包最让人头疼的就是各种权限配置。entitlementsInherit这个配置项必须正确设置，否则应用可能无法访问摄像头、麦克风等硬件。
隐私权限描述也很关键。苹果审核很严格，必须明确说明为什么需要这些权限：
mac: extendInfo: NSCameraUsageDescription: '需要摄像头进行视频通话' NSMicrophoneUsageDescription: '需要麦克风进行语音输入'DMG打包时，background配置可以自定义安装界面的背景图。我建议准备一张漂亮的背景图，提升专业感：
dmg: background: build/background.png window: width: 540 height: 3804. Linux平台打包技巧
Linux平台支持多种打包格式，我最推荐AppImage，因为它不需要安装就能运行。配置起来也很简单：
linux: target: AppImage category: Utilitymaintainer信息不能少，这是Linux软件包的惯例。我一般填写公司或团队名称：
linux: maintainer: myteam@company.com对于deb包，可以配置更详细的元数据：
linux: target: deb synopsis: "My Awesome App" description: "A cross-platform application for..."5. 高级配置与优化技巧
ASAR打包是个双刃剑。虽然能提高安全性，但有些原生模块需要解压才能工作。这时就需要asarUnpack配置：
asar: true asarUnpack: - 'node_modules/some-native-module/*'自动更新功能对用户体验很重要。我推荐使用electron-updater配合以下配置：
publish: provider: github repo: my-repo owner: my-username构建速度优化也很关键。使用国内镜像能显著加快Electron下载：
electronDownload: mirror: https://npmmirror.com/mirrors/electron/6. 常见问题排查
打包过程中最常遇到的问题是路径错误。我建议使用绝对路径或者基于项目根目录的相对路径。比如图标文件应该放在build目录下，然后在配置中引用：
icon: build/icon.ico另一个常见问题是依赖缺失。确保所有依赖都正确列在package.json中，并且区分好dependencies和devDependencies。
版本号管理也很重要。我习惯用语义化版本控制，并在打包时自动注入版本号：
extraMetadata: version: 1.0.07. 多平台构建的最佳实践
跨平台构建时，我建议使用CI/CD工具自动化流程。比如GitHub Actions可以这样配置：
jobs: build: strategy: matrix: platform: [windows-latest, macos-latest, ubuntu-latest]环境变量能帮你处理不同平台的差异。比如图标文件在不同平台后缀不同：
icon: build/icon.${os}.${ext}最后，记得测试每个平台的安装包。我遇到过Windows安装包在虚拟机里正常，但实体机出问题的情况。真机测试是必不可少的环节。