建工具入門：用Python配置替代Makefile的編譯指南)
簡介《SCons指南中文翻譯》面向已具備一定Python基礎(chǔ)、希望系統(tǒng)掌握SCons構(gòu)建工具的開發(fā)者與項目維護者幫助其擺脫對專有配置語言的依賴用熟悉的Python腳本組織軟件構(gòu)建流程。資源為1個PDF文件壓縮包約7.49MB內(nèi)容對應(yīng)SCons 4.4.0用戶指南的完整中文譯本目錄結(jié)構(gòu)清晰便于按主題檢索。目前已有472人學(xué)習(xí)下載。全書從安裝Python與SCons、并行安裝多版本講起依次覆蓋簡單C/C與Java項目構(gòu)建、目標文件命名、Glob文件列表、靜態(tài)庫與動態(tài)庫的生成與鏈接并深入節(jié)點對象、依賴關(guān)系判定內(nèi)容簽名、時間戳、MD5及自定義決策函數(shù)、構(gòu)造環(huán)境管理、命令行選項合并與構(gòu)建輸出控制等核心機制。讀者可據(jù)此理解SCons以Python腳本驅(qū)動構(gòu)建的設(shè)計思路掌握多環(huán)境配置、依賴緩存與構(gòu)建清理等實用技巧適合作為查閱手冊隨項目實踐反復(fù)研讀。1. 第一次聽說 SCons它到底是個什么東西你有沒有過這種經(jīng)歷代碼寫完了要編譯運行得手動敲一長串命令gcc -o hello hello.c文件一多就變成十幾行改一個文件還得重新敲一遍。更崩潰的是過兩天你忘了自己當(dāng)時敲的是哪條命令。SCons 就是來解決這個問題的——你寫一個叫SConstruct的配置文件把“要編譯什么、怎么編譯”寫清楚之后每次只需要敲一個scons它自動幫你把該編的編了、該鏈接的鏈接了沒改過的文件它不會重復(fù)勞動。說白了SCons 是一個構(gòu)建工具跟 Make 干的是同一件事。但它有個特別的地方配置文件是用 Python 寫的。你不用去學(xué)一套新的語法只要會一點點 Python就能看懂、能改。這份《SCons 指南中文翻譯》就是把官方那份幾百頁的英文用戶指南翻成了中文從安裝到簡單構(gòu)建、再到庫的鏈接和依賴管理一步步帶著走。適合誰剛接觸構(gòu)建工具、被 Makefile 的 Tab 和縮進折磨過、想找一個“能看懂”的替代方案的新手。2. 為什么值得學(xué)Python 當(dāng)配置語言省的是理解成本2.1 構(gòu)建工具的核心問題讓機器替你記住編譯順序先想清楚一件事構(gòu)建工具到底在解決什么。假設(shè)你有一個項目三個源文件a.c、b.c、c.c最后鏈接成app。手動編譯的流程是先分別編譯成.o再鏈接。如果你只改了b.c理想情況下只需要重新編譯b.o再鏈接一次a.o和c.o不用動。但人腦記不住這些每次全量重編又慢又浪費。構(gòu)建工具就是替你記這件事的。它維護一張“誰依賴誰”的圖app依賴三個.o每個.o依賴對應(yīng)的.c。你改了哪個文件它就順著圖往上找只重編受影響的部分。SCons 做的是同一件事只不過它判斷“文件有沒有變”的方式比 Make 更細——默認用內(nèi)容簽名可以理解為給文件算一個指紋而不是只看時間戳。這意味著你touch一下文件但內(nèi)容沒變它不會傻乎乎地重編。2.2 為什么是 SCons 而不是別的配置即 Python大多數(shù)構(gòu)建工具會發(fā)明一套自己的小語言Make 有 Makefile 語法CMake 有 CMakeLists 語法。你得額外花時間學(xué)這套語法而且它們往往有不少“玄學(xué)”規(guī)則——比如 Makefile 里命令前面必須是 Tab 不能是空格這個坑幾乎每個人都踩過。SCons 的選擇是配置文件就是 Python 腳本。你寫Program(hello.c)這就是一次普通的 Python 函數(shù)調(diào)用。想加條件判斷直接寫if。想循環(huán)直接寫for。不需要學(xué)新語法Python 里能做的事在配置文件里都能做。這份中文指南的價值就在這里——它把官方文檔里那些函數(shù)名、參數(shù)、示例用中文講了一遍你對照著看不用在英文文檔里反復(fù)查詞。提示SCons 需要 Python 3.5 或更高版本。如果你系統(tǒng)里還是 Python 2得先升級否則裝不上最新版。2.3 這份中文翻譯能幫你省掉什么官方用戶指南是英文的結(jié)構(gòu)是按主題鋪開的對新手不太友好——你很難判斷“我該先讀哪章”。這份中文翻譯保留了原文檔的章節(jié)結(jié)構(gòu)但你可以按自己的節(jié)奏來前幾章講安裝和最簡單的構(gòu)建中間講庫、依賴、環(huán)境變量后面才是擴展和高級話題。入門階段你只需要盯住前幾章把“裝好、跑通一個 hello world”這件事做完后面的等用到再翻。我第一次接觸構(gòu)建工具的時候?qū)χ?Makefile 的報錯看了半天最后發(fā)現(xiàn)是縮進用了空格。那種挫敗感很真實。SCons 至少不會在這種地方卡你——Python 的縮進規(guī)則你本來就得遵守不存在“多了一套規(guī)則”的問題。3. 第一步怎么邁裝好、寫三行、跑起來3.1 先確認 Python 在不在打開終端Windows 是命令提示符或 PowerShell敲python -V如果返回類似Python 3.10.4就說明有了。Windows 上如果python不認試試py -V。都沒有的話去 Python 官網(wǎng)下載安裝安裝時記得勾選“Add Python to PATH”。這一步別跳過SCons 本身就是一個 Python 包沒有 Python 它跑不起來。3.2 用 pip 裝 SCons確認 Python 可用之后一條命令python -m pip install scons如果你沒有系統(tǒng)級安裝權(quán)限加--userpython -m pip install --user scons裝完之后驗證一下scons --version能看到版本號比如 4.4.0就說明裝好了。如果提示“命令未找到”大概率是 pip 裝的腳本目錄不在 PATH 里重新開一個終端窗口通常能解決。3.3 第一個例子編譯一個 C 程序找個空目錄新建hello.c#include stdio.h int main() { printf(Hello, SCons!\n); return 0; }同目錄下新建一個文件名字必須叫SConstruct注意大小寫沒有后綴內(nèi)容只有一行Program(hello.c)就這一行。Program是 SCons 提供的一個構(gòu)建器方法意思是“我要生成一個可執(zhí)行程序源文件是 hello.c”。它自動推導(dǎo)出中間產(chǎn)物叫hello.o、最終產(chǎn)物叫helloWindows 上是hello.exe你不需要手動指定。然后在終端里在這個目錄下運行scons你會看到類似這樣的輸出scons: Reading SConscript files ... scons: done reading SConscript files. scons: Building targets ... gcc -o hello.o -c hello.c gcc -o hello hello.o scons: done building targets.再運行./helloWindows 是hello.exe屏幕上打出Hello, SCons!。到這一步你已經(jīng)跑通了 SCons 最核心的流程寫配置文件、運行 scons、得到產(chǎn)物。3.4 改一行再跑一次看它只做該做的事把hello.c里的文字改成Hello again!再運行scons。你會發(fā)現(xiàn)它只重新編譯了hello.o和鏈接沒有多余動作。再運行一次scons什么都不改它會告訴你scons: . is up to date.什么都不做。這就是構(gòu)建工具的基本邏輯只做必要的事。想清理產(chǎn)物不需要在配置文件里寫清理規(guī)則直接scons -c它會刪掉剛才生成的文件。這個-c就是 clean 的意思比 Make 里手動寫clean目標省事。4. 避坑指南新手最容易翻車的五個地方4.1 文件名寫成sconstruct小寫現(xiàn)象運行scons提示找不到 SConstruct 文件或者什么都沒發(fā)生。原因SCons 默認找的文件名是SConstruct首字母大寫 S其余小寫沒有擴展名。寫成sconstruct、Sconstruct、SConstruct.py都不認。解決確認文件名精確為SConstruct。在 Windows 上還要注意別被資源管理器自動加了.txt后綴。4.2 以為Program(hello.c)里的引號可有可無現(xiàn)象寫成Program(hello.c)報語法錯誤。原因SConstruct是 Python 腳本hello.c不加引號會被當(dāng)成變量名或?qū)傩栽L問Python 解析不了。解決文件名一律加引號單引號雙引號都行養(yǎng)成習(xí)慣。4.3 在錯誤的目錄下運行 scons現(xiàn)象明明有SConstruct運行scons卻說沒有目標可構(gòu)建。原因SCons 只在當(dāng)前目錄及子目錄里找SConstruct你在上級目錄運行它找不到。解決cd到SConstruct所在的目錄再運行。如果項目分多層后面會學(xué)到SConscript的分層寫法入門階段先保持單目錄。4.4 改了源文件但 SCons 沒反應(yīng)現(xiàn)象明明改了.c文件運行scons卻說 up to date。原因SCons 默認用內(nèi)容簽名判斷文件是否變化。如果你只是touch了文件、內(nèi)容沒變它認為不需要重編——這是正確行為不是 bug。另一種可能是你改的文件不在依賴圖里。解決確認你改的確實是參與構(gòu)建的源文件。如果確實需要強制重編可以刪掉產(chǎn)物再跑或者用scons -c清理后重來。4.5 把 SConstruct 當(dāng)普通 Python 腳本直接運行現(xiàn)象python SConstruct報錯。原因SConstruct里用的Program等函數(shù)是 SCons 運行環(huán)境注入的直接拿 Python 跑沒有這些函數(shù)。解決永遠用scons命令來執(zhí)行不要用python SConstruct。5. 下一步學(xué)什么從單文件到多文件按這條線走跑通 hello world 之后你手里已經(jīng)有了一個能用的構(gòu)建環(huán)境。接下來別急著翻完整本指南按下面這條線走每一步都對應(yīng)指南里的具體章節(jié)遇到卡殼再回去查。階段學(xué)什么對應(yīng)指南章節(jié)大概花多久第一步多文件編譯、Glob自動收集源文件第 3 章半天第二步構(gòu)建靜態(tài)庫/動態(tài)庫并鏈接第 4 章半天到一天第三步理解依賴關(guān)系、CPPPATH頭文件搜索第 6 章一天第四步用Environment管理編譯選項第 7 章一天第五步分層構(gòu)建、SConscript拆分大項目第 14 章按需具體怎么練拿你手頭任意一個有兩三個.c文件的小項目把SConstruct從一行Program(hello.c)改成用Glob(*.c)收集所有源文件再跑一遍。然后試著把其中一個文件編成靜態(tài)庫用Library和Program配合鏈接。每改一次就跑一次scons看輸出里哪些命令被執(zhí)行了、哪些被跳過了。這個“看輸出”的習(xí)慣比讀十頁文檔都管用。我第一次用構(gòu)建工具的時候犯過一個很蠢的錯把所有源文件硬編碼在配置里加一個新文件就手動改一次改到第五個文件的時候終于受不了了。后來學(xué)會Glob一行Glob(*.c)全搞定。從那以后我每次新建項目第一件事就是把源文件收集方式寫成通配而不是一個個列——這個習(xí)慣幫我省掉了大量“忘了加新文件導(dǎo)致鏈接報錯”的排查時間。如果你在某個步驟卡住了比如鏈接時提示找不到庫先別懷疑自己翻到指南第 4 章看LIBPATH的用法大概率是路徑?jīng)]配對。構(gòu)建工具的報錯通常很直白把報錯信息里的文件名和路徑對一遍多數(shù)問題自己能定位。希望這份中文指南能幫你把“構(gòu)建”這件事從負擔(dān)變成順手工具幫到你。本文還有配套的精品資源點擊獲取 SCons構(gòu)建工具入門：用Python配置替代Makefile的編譯指南
簡介《SCons指南中文翻譯》面向已具備一定Python基礎(chǔ)、希望系統(tǒng)掌握SCons構(gòu)建工具的開發(fā)者與項目維護者幫助其擺脫對專有配置語言的依賴用熟悉的Python腳本組織軟件構(gòu)建流程。資源為1個PDF文件壓縮包約7.49MB內(nèi)容對應(yīng)SCons 4.4.0用戶指南的完整中文譯本目錄結(jié)構(gòu)清晰便于按主題檢索。目前已有472人學(xué)習(xí)下載。全書從安裝Python與SCons、并行安裝多版本講起依次覆蓋簡單C/C與Java項目構(gòu)建、目標文件命名、Glob文件列表、靜態(tài)庫與動態(tài)庫的生成與鏈接并深入節(jié)點對象、依賴關(guān)系判定內(nèi)容簽名、時間戳、MD5及自定義決策函數(shù)、構(gòu)造環(huán)境管理、命令行選項合并與構(gòu)建輸出控制等核心機制。讀者可據(jù)此理解SCons以Python腳本驅(qū)動構(gòu)建的設(shè)計思路掌握多環(huán)境配置、依賴緩存與構(gòu)建清理等實用技巧適合作為查閱手冊隨項目實踐反復(fù)研讀。1. 第一次聽說 SCons它到底是個什么東西你有沒有過這種經(jīng)歷代碼寫完了要編譯運行得手動敲一長串命令gcc -o hello hello.c文件一多就變成十幾行改一個文件還得重新敲一遍。更崩潰的是過兩天你忘了自己當(dāng)時敲的是哪條命令。SCons 就是來解決這個問題的——你寫一個叫SConstruct的配置文件把“要編譯什么、怎么編譯”寫清楚之后每次只需要敲一個scons它自動幫你把該編的編了、該鏈接的鏈接了沒改過的文件它不會重復(fù)勞動。說白了SCons 是一個構(gòu)建工具跟 Make 干的是同一件事。但它有個特別的地方配置文件是用 Python 寫的。你不用去學(xué)一套新的語法只要會一點點 Python就能看懂、能改。這份《SCons 指南中文翻譯》就是把官方那份幾百頁的英文用戶指南翻成了中文從安裝到簡單構(gòu)建、再到庫的鏈接和依賴管理一步步帶著走。適合誰剛接觸構(gòu)建工具、被 Makefile 的 Tab 和縮進折磨過、想找一個“能看懂”的替代方案的新手。2. 為什么值得學(xué)Python 當(dāng)配置語言省的是理解成本2.1 構(gòu)建工具的核心問題讓機器替你記住編譯順序先想清楚一件事構(gòu)建工具到底在解決什么。假設(shè)你有一個項目三個源文件a.c、b.c、c.c最后鏈接成app。手動編譯的流程是先分別編譯成.o再鏈接。如果你只改了b.c理想情況下只需要重新編譯b.o再鏈接一次a.o和c.o不用動。但人腦記不住這些每次全量重編又慢又浪費。構(gòu)建工具就是替你記這件事的。它維護一張“誰依賴誰”的圖app依賴三個.o每個.o依賴對應(yīng)的.c。你改了哪個文件它就順著圖往上找只重編受影響的部分。SCons 做的是同一件事只不過它判斷“文件有沒有變”的方式比 Make 更細——默認用內(nèi)容簽名可以理解為給文件算一個指紋而不是只看時間戳。這意味著你touch一下文件但內(nèi)容沒變它不會傻乎乎地重編。2.2 為什么是 SCons 而不是別的配置即 Python大多數(shù)構(gòu)建工具會發(fā)明一套自己的小語言Make 有 Makefile 語法CMake 有 CMakeLists 語法。你得額外花時間學(xué)這套語法而且它們往往有不少“玄學(xué)”規(guī)則——比如 Makefile 里命令前面必須是 Tab 不能是空格這個坑幾乎每個人都踩過。SCons 的選擇是配置文件就是 Python 腳本。你寫Program(hello.c)這就是一次普通的 Python 函數(shù)調(diào)用。想加條件判斷直接寫if。想循環(huán)直接寫for。不需要學(xué)新語法Python 里能做的事在配置文件里都能做。這份中文指南的價值就在這里——它把官方文檔里那些函數(shù)名、參數(shù)、示例用中文講了一遍你對照著看不用在英文文檔里反復(fù)查詞。提示SCons 需要 Python 3.5 或更高版本。如果你系統(tǒng)里還是 Python 2得先升級否則裝不上最新版。2.3 這份中文翻譯能幫你省掉什么官方用戶指南是英文的結(jié)構(gòu)是按主題鋪開的對新手不太友好——你很難判斷“我該先讀哪章”。這份中文翻譯保留了原文檔的章節(jié)結(jié)構(gòu)但你可以按自己的節(jié)奏來前幾章講安裝和最簡單的構(gòu)建中間講庫、依賴、環(huán)境變量后面才是擴展和高級話題。入門階段你只需要盯住前幾章把“裝好、跑通一個 hello world”這件事做完后面的等用到再翻。我第一次接觸構(gòu)建工具的時候?qū)χ?Makefile 的報錯看了半天最后發(fā)現(xiàn)是縮進用了空格。那種挫敗感很真實。SCons 至少不會在這種地方卡你——Python 的縮進規(guī)則你本來就得遵守不存在“多了一套規(guī)則”的問題。3. 第一步怎么邁裝好、寫三行、跑起來3.1 先確認 Python 在不在打開終端Windows 是命令提示符或 PowerShell敲python -V如果返回類似Python 3.10.4就說明有了。Windows 上如果python不認試試py -V。都沒有的話去 Python 官網(wǎng)下載安裝安裝時記得勾選“Add Python to PATH”。這一步別跳過SCons 本身就是一個 Python 包沒有 Python 它跑不起來。3.2 用 pip 裝 SCons確認 Python 可用之后一條命令python -m pip install scons如果你沒有系統(tǒng)級安裝權(quán)限加--userpython -m pip install --user scons裝完之后驗證一下scons --version能看到版本號比如 4.4.0就說明裝好了。如果提示“命令未找到”大概率是 pip 裝的腳本目錄不在 PATH 里重新開一個終端窗口通常能解決。3.3 第一個例子編譯一個 C 程序找個空目錄新建hello.c#include stdio.h int main() { printf(Hello, SCons!\n); return 0; }同目錄下新建一個文件名字必須叫SConstruct注意大小寫沒有后綴內(nèi)容只有一行Program(hello.c)就這一行。Program是 SCons 提供的一個構(gòu)建器方法意思是“我要生成一個可執(zhí)行程序源文件是 hello.c”。它自動推導(dǎo)出中間產(chǎn)物叫hello.o、最終產(chǎn)物叫helloWindows 上是hello.exe你不需要手動指定。然后在終端里在這個目錄下運行scons你會看到類似這樣的輸出scons: Reading SConscript files ... scons: done reading SConscript files. scons: Building targets ... gcc -o hello.o -c hello.c gcc -o hello hello.o scons: done building targets.再運行./helloWindows 是hello.exe屏幕上打出Hello, SCons!。到這一步你已經(jīng)跑通了 SCons 最核心的流程寫配置文件、運行 scons、得到產(chǎn)物。3.4 改一行再跑一次看它只做該做的事把hello.c里的文字改成Hello again!再運行scons。你會發(fā)現(xiàn)它只重新編譯了hello.o和鏈接沒有多余動作。再運行一次scons什么都不改它會告訴你scons: . is up to date.什么都不做。這就是構(gòu)建工具的基本邏輯只做必要的事。想清理產(chǎn)物不需要在配置文件里寫清理規(guī)則直接scons -c它會刪掉剛才生成的文件。這個-c就是 clean 的意思比 Make 里手動寫clean目標省事。4. 避坑指南新手最容易翻車的五個地方4.1 文件名寫成sconstruct小寫現(xiàn)象運行scons提示找不到 SConstruct 文件或者什么都沒發(fā)生。原因SCons 默認找的文件名是SConstruct首字母大寫 S其余小寫沒有擴展名。寫成sconstruct、Sconstruct、SConstruct.py都不認。解決確認文件名精確為SConstruct。在 Windows 上還要注意別被資源管理器自動加了.txt后綴。4.2 以為Program(hello.c)里的引號可有可無現(xiàn)象寫成Program(hello.c)報語法錯誤。原因SConstruct是 Python 腳本hello.c不加引號會被當(dāng)成變量名或?qū)傩栽L問Python 解析不了。解決文件名一律加引號單引號雙引號都行養(yǎng)成習(xí)慣。4.3 在錯誤的目錄下運行 scons現(xiàn)象明明有SConstruct運行scons卻說沒有目標可構(gòu)建。原因SCons 只在當(dāng)前目錄及子目錄里找SConstruct你在上級目錄運行它找不到。解決cd到SConstruct所在的目錄再運行。如果項目分多層后面會學(xué)到SConscript的分層寫法入門階段先保持單目錄。4.4 改了源文件但 SCons 沒反應(yīng)現(xiàn)象明明改了.c文件運行scons卻說 up to date。原因SCons 默認用內(nèi)容簽名判斷文件是否變化。如果你只是touch了文件、內(nèi)容沒變它認為不需要重編——這是正確行為不是 bug。另一種可能是你改的文件不在依賴圖里。解決確認你改的確實是參與構(gòu)建的源文件。如果確實需要強制重編可以刪掉產(chǎn)物再跑或者用scons -c清理后重來。4.5 把 SConstruct 當(dāng)普通 Python 腳本直接運行現(xiàn)象python SConstruct報錯。原因SConstruct里用的Program等函數(shù)是 SCons 運行環(huán)境注入的直接拿 Python 跑沒有這些函數(shù)。解決永遠用scons命令來執(zhí)行不要用python SConstruct。5. 下一步學(xué)什么從單文件到多文件按這條線走跑通 hello world 之后你手里已經(jīng)有了一個能用的構(gòu)建環(huán)境。接下來別急著翻完整本指南按下面這條線走每一步都對應(yīng)指南里的具體章節(jié)遇到卡殼再回去查。階段學(xué)什么對應(yīng)指南章節(jié)大概花多久第一步多文件編譯、Glob自動收集源文件第 3 章半天第二步構(gòu)建靜態(tài)庫/動態(tài)庫并鏈接第 4 章半天到一天第三步理解依賴關(guān)系、CPPPATH頭文件搜索第 6 章一天第四步用Environment管理編譯選項第 7 章一天第五步分層構(gòu)建、SConscript拆分大項目第 14 章按需具體怎么練拿你手頭任意一個有兩三個.c文件的小項目把SConstruct從一行Program(hello.c)改成用Glob(*.c)收集所有源文件再跑一遍。然后試著把其中一個文件編成靜態(tài)庫用Library和Program配合鏈接。每改一次就跑一次scons看輸出里哪些命令被執(zhí)行了、哪些被跳過了。這個“看輸出”的習(xí)慣比讀十頁文檔都管用。我第一次用構(gòu)建工具的時候犯過一個很蠢的錯把所有源文件硬編碼在配置里加一個新文件就手動改一次改到第五個文件的時候終于受不了了。后來學(xué)會Glob一行Glob(*.c)全搞定。從那以后我每次新建項目第一件事就是把源文件收集方式寫成通配而不是一個個列——這個習(xí)慣幫我省掉了大量“忘了加新文件導(dǎo)致鏈接報錯”的排查時間。如果你在某個步驟卡住了比如鏈接時提示找不到庫先別懷疑自己翻到指南第 4 章看LIBPATH的用法大概率是路徑?jīng)]配對。構(gòu)建工具的報錯通常很直白把報錯信息里的文件名和路徑對一遍多數(shù)問題自己能定位。希望這份中文指南能幫你把“構(gòu)建”這件事從負擔(dān)變成順手工具幫到你。本文還有配套的精品資源點擊獲取