如何使用NSIS脚本更新旧版本工具的文件、库及DLL

前置准备 #

• 确认旧版本工具的安装路径存储位置：大部分软件会把安装路径写入注册表，比如HKLM\Software\[厂商名]\[工具名]或HKCU\Software\[厂商名]\[工具名]下的InstallLocation项，先提前定位好这个键值。
• 准备好新版本的所有待替换文件：包括主程序、lib库、DLL、资源文件等，整理到安装包的指定目录（比如./new_files/）。

核心脚本实现步骤 #

以下是完整的NSIS脚本示例，包含关键的替换逻辑：

!include LogicLib.nsh
!include FileFunc.nsh
!xdefine VENDOR_NAME "你的厂商名称"
!xdefine APP_NAME "你的工具名称"
!xdefine BACKUP_DIR "$TEMP\${APP_NAME}_old_backup"

; 请求管理员权限（替换Program Files下的文件必须）
RequestExecutionLevel admin

Section "替换旧版本文件" SEC01
    ; 1. 读取旧版本安装路径
    Var /GLOBAL OLD_INSTALL_PATH
    ReadRegStr $OLD_INSTALL_PATH HKLM "Software\${VENDOR_NAME}\${APP_NAME}" "InstallLocation"
    
    ; 检查路径是否存在，不存在则退出
    ${If} $OLD_INSTALL_PATH == ""
        MessageBox MB_OK "未检测到旧版本安装路径，无法执行替换"
        Abort
    ${EndIf}
    ${IfNot} ${FileExists} "$OLD_INSTALL_PATH\"
        MessageBox MB_OK "旧版本安装路径不存在，无法执行替换"
        Abort
    ${EndIf}

    ; 2. 停止旧版本正在运行的进程（避免DLL/文件被占用）
    Var /GLOBAL APP_PROCESS_NAME
    StrCpy $APP_PROCESS_NAME "你的工具进程名.exe"
    ProcessClose $APP_PROCESS_NAME
    ; 等待几秒确保进程完全退出
    Sleep 2000

    ; 3. 备份旧版本文件（可选但建议）
    CreateDirectory "${BACKUP_DIR}"
    CopyFiles /SILENT /FILESONLY "$OLD_INSTALL_PATH\*.*" "${BACKUP_DIR}\"

    ; 4. 复制新版本文件覆盖旧路径
    ; 注意：如果有需要保留的配置文件，这里要排除，比如用/EXCLUDE参数
    CopyFiles /SILENT /OVERWRITE "$INSTDIR\new_files\*.*" "$OLD_INSTALL_PATH\"

    ; 5. 恢复自定义配置文件（如果有）
    ; 示例：把备份的config.ini复制回原路径，覆盖新版本的默认配置
    ; CopyFiles /SILENT /OVERWRITE "${BACKUP_DIR}\config.ini" "$OLD_INSTALL_PATH\"

    ; 6. 可选：清理备份文件（替换成功后执行）
    ; RMDir /R "${BACKUP_DIR}"

    MessageBox MB_OK "新版本文件替换完成！"
SectionEnd

关键细节处理 #

• 文件占用问题：如果替换时提示DLL或文件被占用，除了用ProcessClose停止主进程，还可以用NSIS的KillProcDLL插件强制终止相关进程，或者在脚本中加入进程检测逻辑，确保所有关联进程都已退出。
• 配置文件保留：如果旧版本有用户自定义的配置文件（如.ini、.xml），不要直接覆盖，建议先备份，替换完成后再将旧配置复制回去，或者在CopyFiles时用/EXCLUDE参数排除这些文件。
• 版本校验：可以在脚本中加入版本判断逻辑，读取旧版本文件的版本号，只有当新版本号高于旧版本时才执行替换，避免降级操作：

  ; 读取旧版本主程序的版本号
  GetFileVersion "$OLD_INSTALL_PATH\${APP_PROCESS_NAME}" $R0 $R1 $R2 $R3
  StrCpy $OLD_VER "$R0.$R1.$R2.$R3"
  ; 读取新版本主程序的版本号
  GetFileVersion "$INSTDIR\new_files\${APP_PROCESS_NAME}" $R0 $R1 $R2 $R3
  StrCpy $NEW_VER "$R0.$R1.$R2.$R3"
  ; 比较版本号，新版本更低则退出
  ${VersionCompare} $OLD_VER $NEW_VER $R0
  ${If} $R0 == 1
      MessageBox MB_OK "新版本版本号低于旧版本，终止替换"
      Abort
  ${EndIf}
  

• 权限问题：一定要加上RequestExecutionLevel admin，否则替换Program Files或Program Files (x86)下的文件会因权限不足失败。

注意事项 #

• 测试时一定要在虚拟机或测试环境中验证，避免误操作导致原工具损坏。
• 如果旧版本有服务关联，需要先停止对应的Windows服务，替换完成后再重启服务。

内容的提问来源于stack exchange，提问作者SSW