این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

پیکربندی کد ویژوال استودیو

Visual Studio یک ویرایشگر کد رایگان است که بر روی سیستم عامل های macOS ، Linux و Windows کار می کند.

این نرم افزار ابزار خوبی برای توسعه پایتون و C ++ ، اشکال زدایی بصری ، ادغام گیت و بسیاری از ویژگی های مفید دیگر دارد. این یک ویرایشگر عالی برای استفاده از TensorFlow IO است ، اما برای پیکربندی صحیح آن تلاش زیادی می کند. پیکربندی VSCode بسیار انعطاف پذیر است ، این امکان را فراهم می کند تا پروژه را با استفاده از بازل ، و کد در حال اجرا در debuggers Python و C ++ اجرا کنید. این کتابچه راهنما برای لینوکس است ، سایر سیستم عامل ها می توانند مشخصات خاصی داشته باشند ، اما رویکرد باید مشابه باشد.

برنامه های افزودنی

برای نصب یک برنامه افزودنی ، روی نماد نمایش پسوند (Extensions) در نوار کناری کلیک کنید یا از میانبر Ctrl + Shift + X استفاده کنید. سپس کلید واژه زیر را جستجو کنید.

  • C / C ++ - برنامه افزودنی رسمی C ++ از Microsoft
  • پایتون - فرمت رسمی پایتون از مایکروسافت
  • پک افزونه پایتون - یکی دیگر از برنامه های مفید دیگر برای توسعه پایتون

تدوین پروژه ها

TensorFlow IO با استفاده از دستور ساخت bazel وارد شده است:

 bazel build -s --verbose_failures --compilation_mode dbg //tensorflow_io/...
 

برای جزئیات در مورد چگونگی تنظیم محیط توسعه در اوبونتو ، پرونده README پروژه را ببینید. --compilation_mode dbg پرچم در اینجا نشان می دهد که باینری تولید شده باید دارای علائم اشکال زدایی باشد. هنگامی که می توانید پروژه را از خط فرمان کامپایل کنید ، می توانید VSCode را پیکربندی کنید تا بتوانید همان فرمان را فراخوانی کنید.

View-> Command Pallete را باز کنید (Ctrl + Shift + P) و شروع به تایپ کنید: "کارها: پیکربندی ساخت کار". اگر شما برای اولین بار این کار را انجام می دهید ، ویرایشگر قصد دارد فایل وظایف.json ایجاد کند. پس از در اختیار داشتن ، json را دنبال کنید:

 {
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build TF.IO (Debug)",
            "type": "shell",
            "command": "bazel build -s --verbose_failures --compilation_mode dbg //tensorflow_io/...",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}
 

اکنون می توانید "Ctrl + Shift + B" را فشار دهید ، و VSCode قصد دارد از دستور فوق برای ساخت پروژه استفاده کند. از پنجره ترمینال مخصوص خود استفاده می کند ، جایی که کلیه لینک ها قابل کلیک هستند. بنابراین وقتی خطای تلفیقی رخ داد ، فقط می توانید روی پیوند کلیک کنید ، و ویرایشگر فایل مربوطه را باز کرده و به خط حرکت می کند.

اشکال زدایی پروژه ها

اشکال زدایی در کد پایتون امری بی اهمیت است ، برای فهمیدن نحوه پیکربندی VSCode ، اسناد رسمی را دنبال کنید تا بتوانید: https://code.visualstudio.com/docs/python/debugging اشکال زدایی کد C ++ نیاز به نصب GDB روی سیستم شما دارد. اگر یک اسکریپت python bq_sample_read.py دارید که از کتابخانه tensorflow-io استفاده می کند که به طور معمول اجرا می شود مانند:

 python3 bq_sample_read.py --gcp_project_id=...
 

برای اجرای آن تحت GDB ، موارد زیر را اجرا کنید:

 gdb -ex r --args python3 bq_sample_read.py --gcp_project_id=...
 

اگر برنامه در کد C ++ خراب شود ، می توانید backtrace در کنسول GDB اجرا کنید تا stacktrace دریافت کنید.

VSCode همچنین دارای پشتیبانی از اشکال زدایی GDB است ، این امکان را به شما می دهد تا نقاط ضعف را اضافه کنید ، مقادیر متغیرها را ببینید و از طریق کد عبور کنید. برای افزودن پیکربندی اشکال ، نماد Debug View (اشکال زدایی) را در نوار کناری فشار دهید ، یا از میانبر Ctrl + Shift + D استفاده کنید. در اینجا ، فلش پایین به پایین کنار دکمه پخش را فشار داده و "Add Configuration ..." را انتخاب کنید. این فایل start.json را ایجاد می کند ، پیکربندی زیر را در اینجا اضافه کنید:

 {
    "name": "(gdb) Launch",
    "type": "cppdbg",
    "request": "launch",
    "program": "/usr/bin/python3",
    "args": ["bq_sample_read.py", "--gcp_project_id=..."],
    "stopAtEntry": false,
    "cwd": "${workspaceFolder}",
    "environment": [
        {
            /* path to your bazel-bin folder */
            "name": "TFIO_DATAPATH",
            "value": "/usr/local/google/home/io/bazel-bin"
        },
        {
            /* other env variables to use */
            "name": "GOOGLE_APPLICATION_CREDENTIALS",
            "value": "..."
        }
    ],
    "externalConsole": false,
    "MIMode": "gdb",
    "setupCommands": [
        {
            "description": "Enable pretty-printing for gdb",
            "text": "-enable-pretty-printing",
            "ignoreFailures": true
        }
    ]
}
 

اگر همه چیز به درستی پیکربندی شده است ، باید بتوانید Run -> Start Debugging (F5) یا Run -> Run بدون اشکال زدایی (Ctrl + F5) را انجام دهید. با این کار کد شما تحت اشکال زدایی اجرا می شود:

اشکال زدایی VSCode

نکته دیگری که برای ساده سازی تجربه اشکال زدایی باید انجام شود پیکربندی GDB برای جستجوی کتابخانه های استاندارد C ++ است ، بنابراین شما به کدهایی که به آن اهمیتی نمی دهید قدم می گذارید. برای انجام این کار ، پرونده ~/.gdbinit را با محتوای زیر ایجاد کنید:

 skip -gfi /usr/include/c++/*/*/*
skip -gfi /usr/include/c++/*/*
skip -gfi /usr/include/c++/*
 

قالب بندی پرونده ها

همیشه می توانید پرونده C ++ یا Python را با کلیک راست - دوباره قالب بندی کنید (Ctrl + Shift + I) ، اما VSCode از شیوه های مختلفی استفاده می کند. خوشبختانه تغییر آسان است.

برای قالب بندی پایتون ، به https://donjayamanne.github.io/pythonVSCodeDocs/docs/formatting/ مراجعه کنید.

برای پیکربندی قالب C ++ ، موارد زیر را انجام دهید:

  • برو به تنظیمات برگزیده -> تنظیمات
  • C_Cpp.clang_format_fallbackStyle را جستجو کنید
  • پرونده را مستقیماً تغییر دهید
  • زیر را اضافه کنید
 "C_Cpp.clang_format_fallbackStyle": "{ BasedOnStyle: Google}"