一、设置 Avalonia 程序图标（Windows 平台）

Avalonia 设置程序图标需要分项目配置和发布配置两步，单文件发布模式下图标设置有特殊要求：

步骤 1：添加图标文件到项目准备图标文件：推荐使用 .ico 格式（支持多尺寸，如 16x16/32x32/64x64/256x256），命名为app.ico，放到项目根目录。修改项目文件（.csproj）：添加图标配置和单文件图标指定（关键）：

<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <!-- 基础配置 --> <OutputType>WinExe</OutputType> <TargetFramework>net8.0</TargetFramework> <UseAvalonia>true</UseAvalonia> <!-- 1. 设置程序默认图标（非单文件模式） --> <ApplicationIcon>app.ico</ApplicationIcon> <!-- 2. 单文件发布时的图标指定（关键！） --> <SingleFileIcon>app.ico</SingleFileIcon> <!-- 可选：禁用默认的Windows控制台窗口（仅GUI程序） --> <DisableWinExeOutputInference>false</DisableWinExeOutputInference> </PropertyGroup> <!-- 确保图标文件被复制到输出目录 --> <ItemGroup> <None Include="app.ico"> <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> </None> </ItemGroup></Project>步骤 2：发布时强制指定图标（兜底方案）

如果上述配置仍不生效，可在发布命令中直接指定图标参数：

dotnet publish -c Release -r win-x64 --self-contained true ` /p:PublishSingleFile=true ` /p:IncludeNativeLibrariesForSelfExtract=true ` /p:TrimMode=partial ` /p:PublishReadyToRun=true ` /p:ApplicationIcon=app.ico ` /p:SingleFileIcon=app.ico验证图标是否生效发布完成后，先查看publish目录下的 exe 文件是否显示自定义图标（单文件 exe 可能需要刷新资源管理器）；如果使用 Inno Setup 打包安装包，需在脚本中添加图标指定（可选）：ini[Setup] SetupIconFile=app.ico ; 安装程序自身的图标 [Icons] Name: "{commondesktop}\EasyPlot"; Filename: "{app}\EasyPlot.exe"; IconFilename: "{app}\app.ico"二、优化发布体积（从 150MB 减小到合理范围）

150MB 的体积主要是因为自包含模式包含了完整的.NET 运行时 + Avalonia 依赖 + 未裁剪的代码，以下是分层优化方案：

方案 1：基础优化（无副作用，优先做）

修改发布命令，增加更激进的裁剪和压缩参数：

dotnet publish -c Release -r win-x64 --self-contained true ` /p:PublishSingleFile=true ` /p:IncludeNativeLibrariesForSelfExtract=true ` # 1. 全量裁剪（比partial更彻底） /p:TrimMode=full ` # 2. 启用压缩（单文件内部压缩） /p:EnableCompressionInSingleFile=true ` # 3. 禁用ReadyToRun（体积换启动速度，可选） /p:PublishReadyToRun=false ` # 4. 排除调试符号 /p:DebugType=none ` /p:DebugSymbols=false ` # 5. 裁剪本地化资源（仅保留中文/英文） /p:SatelliteResourceLanguages=zh-CN,en-US方案 2：进阶优化（需验证功能）修改项目文件，启用深度裁剪：<PropertyGroup> <!-- 允许裁剪Avalonia的未使用组件 --> <TrimUnusedDependencies>true</TrimUnusedDependencies> <!-- 裁剪时保留Avalonia必要的类型（防止裁剪过度导致崩溃） --> <TrimmerRootAssembly Include="Avalonia" /> <TrimmerRootAssembly Include="Avalonia.Controls" /></PropertyGroup>排除不必要的依赖：检查项目依赖，移除未使用的 NuGet 包（比如如果没用 ReactiveUI 的某些模块、ScottPlot 的额外插件等）。方案 3：放弃自包含（最小体积，需用户装.NET 运行时）

如果允许用户安装.NET 8 运行时，可关闭--self-contained true，体积会骤降到 10-20MB：

dotnet publish -c Release -r win-x64 --self-contained false ` /p:PublishSingleFile=true ` /p:EnableCompressionInSingleFile=true优点：体积极小；缺点：用户需先安装.NET 8 Desktop Runtime（可引导用户从微软官网下载）。方案 4：拆分单文件（平衡体积和启动速度）

如果单文件压缩后仍大，可关闭PublishSingleFile，只打包为文件夹模式，再用 7-Zip 自解压包压缩：

# 1. 发布为文件夹模式dotnet publish -c Release -r win-x64 --self-contained true /p:TrimMode=full /p:EnableCompressionInSingleFile=false# 2. 用7-Zip制作自解压包（比单文件更小，启动更快）三、体积大的原因分析

150MB 的核心原因：

.NET 8 运行时（win-x64 约 80MB）；Avalonia 及依赖（ScottPlot/SukiUI/Material.Icons 等约 50MB）；单文件模式的自解压开销 + 未裁剪的冗余代码 / 资源。总结图标设置关键：项目文件中同时配置ApplicationIcon和SingleFileIcon；单文件发布必须指定SingleFileIcon（这是容易遗漏的点）。体积优化核心：启用TrimMode=full + EnableCompressionInSingleFile=true（基础优化）；非必须场景关闭--self-contained true（最大幅度减小体积）；裁剪未使用的依赖和本地化资源。体积参考：优化后自包含模式可降到 60-80MB，非自包含模式可降到 10-20MB。

如果优化后仍有体积问题，可检查是否包含了大型资源文件（如示例数据、图片等），这类文件建议单独打包，不放入单文件中。