在嵌入式AI開(kāi)發(fā)中，將Deepseek大模型部署到RK3588（瑞芯微高性能SoC）是實(shí)現(xiàn)邊緣端智能應(yīng)用的關(guān)鍵需求。但很多開(kāi)發(fā)者會(huì)卡在編譯配置、依賴沖突等環(huán)節(jié)。本文基于實(shí)際操作流程，詳細(xì)講解直接在RK3588板子上編譯Deepseek可執(zhí)行程序的完整步驟，包含CMake配置、代碼上傳、常見(jiàn)報(bào)錯(cuò)解決，幫你避開(kāi)所有“坑”。

本文將圍繞以下4部分展開(kāi)：

1.部署前必備準(zhǔn)備（硬件/軟件/工具）

2.核心配置：CMakeLists.txt解析與修改

3.分步操作：代碼上傳→編譯→報(bào)錯(cuò)解決

4.編譯成功驗(yàn)證與總結(jié)

一、部署前準(zhǔn)備：確認(rèn)這些“必需品”

在開(kāi)始操作前，先確保你的環(huán)境滿足以下條件，避免后續(xù)反復(fù)返工：

先通過(guò)以下命令驗(yàn)證系統(tǒng)編譯工具是否可用（若有輸出則正常）：

# 查看GCC版本gcc --version# 查看G++版本g++ --version# 確認(rèn)工具鏈路徑（本文默認(rèn)路徑為/usr/bin/）whichaarch64-linux-gnu-gcc

二、核心配置：修改CMakeLists.txt

CMakeLists.txt是編譯的“指揮文件”，需根據(jù)RK3588環(huán)境調(diào)整工具鏈路徑、依賴庫(kù)引用與安裝配置。以下是完整配置代碼及關(guān)鍵參數(shù)解析：

# 1. 最低CMake版本要求（需≥3.8，避免語(yǔ)法不兼容）cmake_minimum_required(VERSION 3.8)# 2. 項(xiàng)目名稱（自定義，建議含硬件標(biāo)識(shí)）project(xsc_deepseek_rkllm_demo)# 3. C++標(biāo)準(zhǔn)配置（固定C++11，適配多數(shù)嵌入式環(huán)境）set(CMAKE_CXX_STANDARD 11)set(CMAKE_CXX_STANDARD_REQUIRED ON)# 4. 工具鏈路徑配置（關(guān)鍵！需與RK3588實(shí)際路徑匹配）set(TOOLCHAIN_DIR /usr) # 工具鏈根目錄set(CMAKE_CXX_COMPILER${TOOLCHAIN_DIR}/bin/aarch64-linux-gnu-g++) # C++編譯器set(CMAKE_C_COMPILER${TOOLCHAIN_DIR}/bin/aarch64-linux-gnu-gcc)  # C編譯器# 5. 源碼目錄與頭文件路徑（指定Deepseek源碼根目錄，引入RKLLM頭文件）set(CMAKE_SOURCE_DIR /data/xsc_deepseek)include_directories(${CMAKE_SOURCE_DIR}/lib/librkllm_api/include/)# 6. 依賴庫(kù)配置（鏈接RKLLM推理庫(kù)與OpenMP庫(kù)）set(RKLLM_RT_LIB${CMAKE_SOURCE_DIR}/lib/librkllm_api/librkllmrt.so) # RKLLM核心庫(kù)set(GOMP_LIB${CMAKE_SOURCE_DIR}/lib/libgomp/libgomp.so)       # OpenMP并行庫(kù)# 7. 生成可執(zhí)行程序（指定源碼文件main.cc，輸出程序名xsc_deepseek_demo）add_executable(xsc_deepseek_demo main.cc)# 8. 鏈接依賴庫(kù)（將程序與RKLLM、OpenMP庫(kù)關(guān)聯(lián)，缺一不可）target_link_libraries(xsc_deepseek_demo${RKLLM_RT_LIB}${GOMP_LIB})# 9. 安裝配置（指定編譯產(chǎn)物的輸出目錄，方便后續(xù)調(diào)用）set(CMAKE_INSTALL_PREFIX${CMAKE_SOURCE_DIR}/install/xsc_deepseek_rkllm_demo)install(TARGETS xsc_deepseek_demo DESTINATION ./) # 安裝可執(zhí)行程序install(DIRECTORY rkllm_model DESTINATION ./)   # 安裝模型文件夾

關(guān)鍵提醒：若你的工具鏈路徑、源碼目錄與本文不同，需同步修改第4、5、6、9行的路徑參數(shù)，這是后續(xù)編譯成功的基礎(chǔ)！

三、分步操作：從代碼上傳到編譯排錯(cuò)

這部分是實(shí)操核心，我們按“上傳→編譯→解決報(bào)錯(cuò)”的順序逐步推進(jìn)，所有命令均來(lái)自實(shí)際RK3588終端操作。

步驟1：將代碼上傳到RK3588的/data路徑

先通過(guò)SSH或U盤將Deepseek源碼壓縮包（xsc_deepseek.zip）傳到RK3588的/data目錄，然后執(zhí)行解壓命令，查看目錄結(jié)構(gòu)是否完整：

# 進(jìn)入/data目錄cd/data# 解壓源碼包unzip xsc_deepseek.zip# 進(jìn)入解壓后的目錄，查看文件列表cdxsc_deepseekls

正常情況下，ls會(huì)輸出以下文件/目錄（確認(rèn)無(wú)缺失）：

build-linux.sh CMakeLists.txt lib main.cc rkllm_model

其中：

?lib/：存放librkllmrt.so和libgomp.so依賴庫(kù)

?rkllm_model/：Deepseek模型文件目錄

?build-linux.sh：編譯腳本

?main.cc：核心業(yè)務(wù)代碼

步驟2：執(zhí)行編譯腳本，解決3類常見(jiàn)報(bào)錯(cuò)

直接運(yùn)行編譯腳本可能會(huì)遇到權(quán)限、時(shí)間戳、依賴庫(kù)3類問(wèn)題，我們逐個(gè)解決：

報(bào)錯(cuò)1：“bash: ./build-linux.sh:權(quán)限不夠”

原因：編譯腳本沒(méi)有可執(zhí)行權(quán)限

解決命令：給腳本賦最高權(quán)限（777表示讀/寫(xiě)/執(zhí)行權(quán)限全開(kāi)）

chmod777 ./build-linux.sh# 重新執(zhí)行編譯腳本./build-linux.sh

報(bào)錯(cuò)2：“警告：文件"../../main.cc"的修改時(shí)間在未來(lái)14665332秒后”

原因：RK3588系統(tǒng)時(shí)間與文件修改時(shí)間不匹配（可能是板子斷網(wǎng)后時(shí)間錯(cuò)亂）

解決命令：手動(dòng)同步系統(tǒng)時(shí)間（本文示例時(shí)間為2025年09月02日18:28，可根據(jù)實(shí)際修改）

# 設(shè)置系統(tǒng)時(shí)間（格式：年-月-日 時(shí)秒）date-s"20250902 1800"# 重新執(zhí)行編譯腳本./build-linux.sh

報(bào)錯(cuò)3：“undefined reference to pthread_getaffinity_np@GLIBC_2.32”

原因：自帶的libgomp.so版本與RK3588的GLIBC（2.32版本）不兼容

解決步驟：

1.先找到系統(tǒng)中兼容的libgomp.so路徑（RK3588默認(rèn)在/usr/lib/gcc/aarch64-linux-gnu/10/）

2.替換源碼目錄中舊的libgomp.so

具體命令：

# 1. 查找系統(tǒng)中所有l(wèi)ibgomp.so路徑find .././ -name libgomp.so# 輸出會(huì)包含：../../usr/lib/gcc/aarch64-linux-gnu/10/libgomp.so（這是兼容版本）# 2. 替換源碼lib目錄下的舊庫(kù)（覆蓋兩個(gè)路徑，確保編譯時(shí)引用正確）cp../../usr/lib/gcc/aarch64-linux-gnu/10/libgomp.so ../../usr/lib/libgomp/libgomp.socp../../usr/lib/gcc/aarch64-linux-gnu/10/libgomp.so ../../userdata/xsc_deepseek/lib/libgomp/libgomp.so# 3. 再次執(zhí)行編譯腳本，此時(shí)無(wú)報(bào)錯(cuò)./build-linux.sh

步驟3：確認(rèn)編譯成功

當(dāng)終端輸出以下信息時(shí)，說(shuō)明編譯與安裝完成：

--Configuringdone--Generatingdone--Buildfiles have been written to:/userdata/xsc_deepseek/build/build_linux_aarch64[50%]LinkingCXXexecutable xsc_deepseek_demo[100%]Builttarget xsc_deepseek_demoInstallthe project...--Installconfiguration:""--Installing:/data/xsc_deepseek/install/xsc_deepseek_rkllm_demo/./xsc_deepseek_demo--Setruntime path of"/data/xsc_deepseek/install/xsc_deepseek_rkllm_demo/./xsc_deepseek_demo"to""--Installing:/data/xsc_deepseek/install/xsc_deepseek_rkllm_demo/./rkllm_model

可通過(guò)以下命令驗(yàn)證產(chǎn)物：

# 進(jìn)入安裝目錄cd/data/xsc_deepseek/install/xsc_deepseek_rkllm_demo# 查看文件（應(yīng)包含可執(zhí)行程序和模型目錄）ls輸出如下即正常：xsc_deepseek_demo rkllm_model

四、總結(jié)：部署關(guān)鍵要點(diǎn)與后續(xù)建議

本次在RK3588上部署Deepseek的核心是“本地編譯+依賴適配”，總結(jié)3個(gè)關(guān)鍵注意點(diǎn)，幫你避免重復(fù)踩坑：

1.CMake配置是基礎(chǔ)：工具鏈路徑、頭文件目錄、依賴庫(kù)必須與RK3588實(shí)際環(huán)境匹配，尤其是TOOLCHAIN_DIR和RKLLM_RT_LIB的路徑不能錯(cuò)；

2.報(bào)錯(cuò)解決有規(guī)律：權(quán)限問(wèn)題用chmod，時(shí)間問(wèn)題用date -s，依賴庫(kù)問(wèn)題用“查找系統(tǒng)兼容庫(kù)+替換”的思路；

3.驗(yàn)證步驟不能少：編譯后一定要到install目錄確認(rèn)可執(zhí)行程序和模型目錄是否存在，為后續(xù)運(yùn)行模型做好準(zhǔn)備。

如果后續(xù)需要運(yùn)行Deepseek模型，只需在安裝目錄執(zhí)行./xsc_deepseek_demo即可（需確保模型配置正確）。若你在操作中遇到其他問(wèn)題，歡迎在評(píng)論區(qū)留言討論！