DocumentazioneSubstance 3DSubstance 3D Designer

Debug dei plug-in con Visual Studio Code

Ultimo aggiornamento: 11 settembre 2026

Come standard del flusso di lavoro per molti sviluppatori, l’IDE codice Visual Studio è disponibile per il debug dei plug-in Python.

WARNING
Il metodo debugpy.Listen() può consentire a chiunque sia in grado di connettersi alla porta specificata di eseguire codice arbitrario all'interno del processo sottoposto a debug.
Pertanto, il debug deve essere solo configurato ed eseguito su reti sicure.

Per impostare la sinergia tra Visual Studio Code e Substance 3D Designer, eseguire la procedura seguente:

  1. Installare Visual Studio Code e Python extension.

  2. Installare il modulo debugpy Python.

    note
    NOTE
    Verificare che l'interprete Python in Designer sia in grado di trovare il modulo 'debugpy'. Il modo più semplice per eseguire questa operazione consiste nell'aggiungere la directory in cui si trova il modulo 'debug' alla variabile di ambiente PYTHONPATH. In alternativa, modificare sys.path nello script per aggiungere il percorso al modulo di debug.

  3. Avvia l’applicazione, apri l’editor Python ed esegui il codice seguente:

    code language-none 
    import sys



debugpy_path = '/path/to/debugpy/module'

debugpy_port = 5678

designer_py_interpreter = '/path/to/python/executable/bundled/in/designer'



if not debugpy_path in sys.path:

    sys.path.append(debugpy_path)



import debugpy



debugpy.configure(python=designer_py_interpreter)

debugpy.listen(debugpy_port)

  4. In Visual Studio Code, apri il progetto e crea un file launch.json. Aggiungi quanto segue al file:

    code language-none 
    {

    "name": "Attach to Designer",

    "type": "python",

    "request": "attach",

    "port": <port number used in the script above>,

    "host": "127.0.0.1"

}

  5. Se necessario, fai clic sull’icona Debug per creare o modificare la configurazione del debugger.

  6. Selezionare la configurazione Python: Attach to Designer e fare clic su Start Debugging.

    È ora possibile impostare i punti di interruzione, scorrere il codice e utilizzare tutte le altre funzionalità del debugger di Visual Studio Code.

recommendation-more-help
substance-3d-designer-help-guide