你的團(tuán)隊(duì)已經(jīng)通過了小程序立項(xiàng)評審，開發(fā)排期就定在下周一。但當(dāng)工程師坐下來準(zhǔn)備開工時(shí)，接連收到三個(gè)“卡住”的消息：沒有管理員微信號綁定不了開發(fā)者權(quán)限，UI 設(shè)計(jì)稿缺了 iOS 底部安全區(qū)適配方案，后臺接口甚至還沒申請 HTTPS 證書——這三件事讓正式編碼推遲了整整五天。這種混亂不是個(gè)例，根源都在于把“開發(fā)前準(zhǔn)備”當(dāng)成了一個(gè)模糊概念，而不是一份可對照執(zhí)行的資料清單。

小程序開發(fā)本質(zhì)上是一個(gè)強(qiáng)約束的工程過程：微信平臺在賬號準(zhǔn)入、代碼審核、域名備案、類目資質(zhì)等環(huán)節(jié)設(shè)定了大量硬性條件。任何一項(xiàng)前置資料的缺失，都不會在你開始寫代碼時(shí)自動消失，只會在最不合時(shí)宜的節(jié)點(diǎn)演變成阻塞項(xiàng)。因此，你需要在進(jìn)入正式開發(fā)之前，把必須的資料一次性收攏到位。

一、賬號與資質(zhì)：先跑通微信生態(tài)的“準(zhǔn)入鏈”

小程序不是你把代碼寫完就能上線的獨(dú)立應(yīng)用，它必須寄生在微信的賬號體系里。這意味著你需要準(zhǔn)備的第一類資料，全部圍繞主體認(rèn)證和開發(fā)者權(quán)限展開。

1. 主體注冊資料

根據(jù)你的運(yùn)營主體類型，微信要求提供的證照截然不同：

• 企業(yè)主體：營業(yè)執(zhí)照（統(tǒng)一社會信用代碼）、對公賬戶信息（用于小額打款驗(yàn)證）、法人或管理員身份證正反面照片。管理員手機(jī)號和微信號必須為同一人且完成實(shí)名認(rèn)證。
• 個(gè)體工商戶：營業(yè)執(zhí)照與經(jīng)營者身份證，同樣需要對公賬戶或法人銀行卡完成驗(yàn)證。
• 政府/事業(yè)單位：統(tǒng)一社會信用代碼證書，以及加蓋公章的機(jī)構(gòu)證明文件。
• 個(gè)人主體：僅需身份證與實(shí)名微信號，但個(gè)人主體不支持微信支付、卡券、附近小程序等商業(yè)能力，類目限制極嚴(yán)。

這里最容易踩坑的是管理員身份綁定。微信要求一個(gè)小程序只有一個(gè)管理員，該管理員微信號必須綁定了銀行卡實(shí)名，且不能同時(shí)管理員超過一定數(shù)量的小程序。正式啟動開發(fā)前，你需要確認(rèn)管理員微信號已預(yù)留、未被其他主體占用，并準(zhǔn)備好管理員身份證與掃碼授權(quán)環(huán)境。

2. 開發(fā)者權(quán)限與密鑰資料

在微信公眾平臺（mp.weixin.qq.com）完成注冊后，你需要立即做兩件事：

• 添加項(xiàng)目成員：將前端、后端工程師的個(gè)人微信號添加到“成員管理”中，設(shè)置相應(yīng)權(quán)限（開發(fā)者、運(yùn)營者、數(shù)據(jù)分析員），權(quán)限一旦缺失，連開發(fā)版都無法上傳。
• 生成密鑰：在“開發(fā)——開發(fā)設(shè)置”中獲取 AppID 和 AppSecret。AppID 相當(dāng)于小程序的唯一標(biāo)識，AppSecret 用于服務(wù)端調(diào)用接口獲取 session_key、access_token 等敏感信息。這里的硬性約束是：AppSecret 必須由服務(wù)端安全存儲，嚴(yán)禁寫在前端代碼中。

如果你計(jì)劃使用微信支付或多端同步功能，還需要在同一階段完成商戶號申請、綁定，以及開平注冊。商戶號申請又需要提供企業(yè)銀行賬戶、營業(yè)執(zhí)照、法人身份證，審核周期通常為 1-3 個(gè)工作日——這些都是跨部門協(xié)調(diào)的典型延期點(diǎn)。

二、產(chǎn)品與設(shè)計(jì)資料：交付給開發(fā)的不能只有“想法”

開發(fā)團(tuán)隊(duì)需要的是可執(zhí)行的定義，而不是方向性描述。很多項(xiàng)目在這個(gè)環(huán)節(jié)反復(fù)拉鋸，根本原因是把“產(chǎn)品梳理”和“設(shè)計(jì)定稿”塞進(jìn)了開發(fā)周期內(nèi)。你需要提前交付的資料至少包含三類基準(zhǔn)件。

1. 功能范圍文檔

一份可用的功能范圍文檔不能是“做一個(gè)商城”這種一句話需求，它必須明確：

• 頁面路徑與頁面名：每一頁面對應(yīng)的 pages 路徑，例如 pages/index/index、pages/order/detail。這是小程序原生框架分包加載和頁面棧調(diào)度的基礎(chǔ)。
• 核心操作流：用戶從進(jìn)入小程序到完成主要任務(wù)的完整流程，用流程圖或編號步驟表達(dá)，標(biāo)注分支條件（如未登錄、庫存不足、支付失敗）。
• 接口依賴表：列出每個(gè)頁面需要調(diào)用的后端接口名稱、請求參數(shù)、返回字段及異常狀態(tài)碼約定。不要等后端寫出接口文檔才反向適配前端邏輯。

2. UI 設(shè)計(jì)稿與適配標(biāo)準(zhǔn)

小程序運(yùn)行在微信的容器層內(nèi)，有自己的一套設(shè)計(jì)規(guī)范，忽視它會直接導(dǎo)致審核被拒或頁面錯(cuò)位。你需要提供給前端開發(fā)的資料包括：

• 750pt 基準(zhǔn)設(shè)計(jì)稿，覆蓋所有頁面與狀態(tài)（加載中、空數(shù)據(jù)、網(wǎng)絡(luò)異常、操作成功/失?。?/li>
• 組件標(biāo)注：字體、顏色、間距、按鈕狀態(tài)（default、hover、disabled）、圖標(biāo)資源以 SVG 或 iconfont 形式交付。
• 安全區(qū)適配說明：明確底部自定義 tabBar 或按鈕如何兼容 iPhone（home indicator 區(qū)域），頂部如何與微信膠囊按鈕保持間距。這部分可以在設(shè)計(jì)稿中用 safe-area-inset-bottom 變量標(biāo)注，并給出預(yù)期 padding 值。
• 小程序特有的交互限制：比如不允許主動分享到朋友圈的頁面，需要標(biāo)注“禁用轉(zhuǎn)發(fā)”；分享卡片圖片的尺寸固定為 5:4（通常 500px*400px），設(shè)計(jì)時(shí)需要單獨(dú)切圖。

如果產(chǎn)品需要適配 PC 端小程序或平板模式，還需要提前約定橫屏布局和窗口縮放斷點(diǎn)。這些約束在產(chǎn)品評審階段如果不輸出為設(shè)計(jì)規(guī)范，后續(xù)改動成本會成倍增加。

3. 內(nèi)容與合規(guī)素材

小程序初次提審如果被拒，最常見的原因之一就是內(nèi)容不完整。開發(fā)階段你需要準(zhǔn)備：

• 靜態(tài)文案：所有頁面上的文字內(nèi)容，包括按鈕文案、提示語、協(xié)議文本（用戶服務(wù)協(xié)議和隱私政策必須以獨(dú)立頁面展示）。
• 類目資質(zhì)附件：特別是醫(yī)療、金融、社交、在線音視頻等強(qiáng)監(jiān)管類目。比如涉及“直播”的小程序，必須提前申請對應(yīng)的類目資質(zhì)并上傳《網(wǎng)絡(luò)文化經(jīng)營許可證》等文件；未取得資質(zhì)前，開發(fā)可以先行搭建調(diào)試環(huán)境，但提審時(shí)必須和代碼一起提交證照。
• 版權(quán)來源證明：若使用了可商用字體、圖片、音視頻素材，保留授權(quán)書或購買記錄，以應(yīng)對審核問詢。

三、技術(shù)與運(yùn)營對接清單：上線不是最后一刻才考慮的事

開發(fā)階段的最后一項(xiàng)準(zhǔn)備工作，是把生產(chǎn)環(huán)境所需的基礎(chǔ)設(shè)施和運(yùn)營配置一次性打通。這些事項(xiàng)如果等到測試階段才去補(bǔ)，往往要重新走審批流、購買證書、修改防火墻規(guī)則，導(dǎo)致上線日期不可控。

1. 服務(wù)器與網(wǎng)絡(luò)配置

小程序的所有網(wǎng)絡(luò)請求必須走 HTTPS 協(xié)議，且域名需在后臺“開發(fā)設(shè)置”中提前配置為 request 合法域名。你需要準(zhǔn)備好：

• 已備案的域名（工信部備案號，微信后臺必填），并為主域名和接口子域名（如 api.yourdomain.com、cdn.yourdomain.com）分別申請 SSL 證書，避免證書名稱與接口地址不匹配導(dǎo)致請求失敗。
• 服務(wù)器 IP 白名單（用于企業(yè)內(nèi)網(wǎng)安全策略）、并發(fā)與帶寬預(yù)估——小程序瞬時(shí)流量可能由“轉(zhuǎn)發(fā)到群”帶來指數(shù)級增長，服務(wù)器需要支持快速擴(kuò)容或至少設(shè)定保護(hù)閾值。
• 如果使用云開發(fā)，則需要預(yù)先準(zhǔn)備環(huán)境 ID 和云函數(shù)部署賬號，確認(rèn)按量付費(fèi)的額度上限是否滿足預(yù)期。

2. 第三方服務(wù)與 SDK 對接資料

當(dāng)小程序需要接入地圖、支付、消息推送、數(shù)據(jù)統(tǒng)計(jì)等服務(wù)時(shí)，每一方都需要獨(dú)立的密鑰和配置：

• 微信支付：商戶號（mch_id）、APIv3 密鑰、證書序列號及私鑰文件 apiclient_key.pem。這些信息必須通過服務(wù)端統(tǒng)一處理，前端僅調(diào)用后端封裝的統(tǒng)一下單接口。
• 騰訊地圖：key（keys 需要通過微信公眾平臺綁定小程序的 AppID 才能調(diào)用）。
• 消息推送：配置模板消息時(shí)，需要提前準(zhǔn)備好模板 ID、行業(yè)類目和每個(gè)字段的參數(shù)格式。模板消息的審核周期常常被低估，盡快提交模板審核可以避免功能完工后被卡住。
• 數(shù)據(jù)埋點(diǎn)與統(tǒng)計(jì)：如果你自主建設(shè)埋點(diǎn)體系，需要提前定義上報(bào)事件和公共參數(shù)（user_id、device_id、場景值 scene 等），并把埋點(diǎn) SDK 的 AppKey 或 token 按環(huán)境區(qū)分（開發(fā)版、體驗(yàn)版、正式版）。

3. 運(yùn)營前置資料

一些功能在開發(fā)時(shí)就需要運(yùn)營資料同步參與，否則測試數(shù)據(jù)跑不通真實(shí)鏈路：

• 測試環(huán)境商戶號與沙箱配置：支付功能的測試不能在生產(chǎn)環(huán)境隨意操作，需要配置微信支付沙箱環(huán)境并導(dǎo)入測試用例（包括余額不足、超時(shí)、取消支付等異常流程）。
• 客服消息配置：如果在線客服使用第三方客服系統(tǒng)，需在開發(fā)階段就完成消息推送 URL、Token 和 EncodingAESKey 的配置，并將客服人員微信號綁定到“客服管理”中。
• 審核輔助材料：一些類目提審時(shí)需要提供測試賬號（如企業(yè)內(nèi)部系統(tǒng)）或錄制操作視頻。提前準(zhǔn)備一個(gè)可用的測試微信號及對應(yīng)密碼，并將操作路徑截圖與視頻歸入提審資料包，可以防止來回打回。

當(dāng)以上三類資料在項(xiàng)目啟動會上逐項(xiàng)核對、責(zé)任到人時(shí)，小程序開發(fā)的阻塞點(diǎn)就從“隨時(shí)可能炸裂的未知風(fēng)險(xiǎn)”變成了“可排期的已知任務(wù)”。建議你直接將本文所列資料轉(zhuǎn)化為一份內(nèi)部檢查表，在開發(fā)排期啟動前組織一次專項(xiàng)評審——未閉環(huán)的項(xiàng)不得進(jìn)入編碼階段。這樣不僅縮短交付周期，更避免把開發(fā)工程師的時(shí)間浪費(fèi)在可以提前解決的事務(wù)性等待上。