Run WeChat Web Dev Tools on Linux: Step‑by‑Step Guide with NW.js & Wine

1. Download NW.js

Download the NW.js SDK from http://nwjs.io/ and extract it.

2. Copy WeChat Web Developer Tool files into NW.js

Copy package.nw, icon.ico, and the WeChat Web Developer Tool executable (or its extracted contents) from the Windows installation folder into the extracted NW.js directory.

3. Modify code to fix module names

Run NW.js from the terminal with ./nw. When errors such as “Cannot find module …” appear, edit the indicated files to correct case‑sensitive module names (e.g., change appServiceConfig to appserviceConfig).

4. Create a run-detectors file

In the WeChat mini‑program project folder, create an empty file named run-detectors. Linux treats files without extensions as directories, so this file prevents “file not found” errors.

5. Install Wine

Install Wine with sudo apt-get install wine. Then run wcc.exe (located in /home/username/.config/微信web开发者工具/WeappVendor) using Wine’s right‑click “Open with Wine” option, installing any required dependencies.

6. Load the project

Before loading, run wcc.exe and wcsc.exe under Wine once; otherwise the first load may fail. After the first load, compilation may take 3–10 seconds, then speeds up due to caching. Rename wcc.exe and wcsc.exe to remove the .exe extension, and edit the paths in commit/build.js, trans/transWxmlToJs.js, and utils/vendorManager.js accordingly.

7. Configure the editor

Use WebStorm (or another IDE) and add wxss to the CSS file type and wxml to the HTML file type in the editor’s file‑type settings. Avoid using the built‑in editor’s edit function, which may cause errors.

Note that automatic refresh after file changes takes about 3–5 seconds for compilation.