İzlenecek yol: Komut satırında yerel bir C++ programı derleme

Visual Studio bir komut satırı C ve C++ derleyicisi içerir. Temel konsol uygulamalarından Evrensel Windows Platformu uygulamalarına, Masaüstü uygulamalarına, cihaz sürücülerine ve .NET bileşenlerine kadar her şeyi oluşturmak için kullanabilirsiniz.

Bu kılavuzda, bir metin düzenleyicisi kullanarak temel bir "Hello, World" stilinde C++ programı oluşturacak ve ardından komut satırında derleyebilirsiniz. Komut satırını kullanmak yerine Visual Studio IDE'yi denemek isterseniz bkz . İzlenecek Yol: Projeler ve Çözümlerle Çalışma (C++) veya C++ Masaüstü Geliştirme için Visual Studio IDE'yi Kullanma.

Bu kılavuzda, burada kullanılan programı yazmak yerine kendi C++ programınızı kullanabilirsiniz. Alternatif olarak, başka bir makaledeki C++ kod örneğini de kullanabilirsiniz.

Önkoşullar

Bu kılavuzu tamamlamak için ya Visual Studio'nun isteğe bağlı C++ ile Masaüstü Geliştirme iş yüküne ya da Visual Studio için komut satırı Derleme Araçları'na sahip olmanız gerekir.

Visual Studio tümleşik bir geliştirme ortamıdır (IDE). Birçok dil ve platform için tam özellikli bir düzenleyiciyi, kaynak yöneticilerini, hata ayıklayıcıları ve derleyicileri destekler. Kullanılabilir sürümler ücretsiz Visual Studio Community sürümünü içerir ve tümü C ve C++ geliştirmesini destekleyebilir. Visual Studio'yu indirme ve yükleme hakkında bilgi için bkz . Visual Studio'da C++ desteğini yükleme.

Visual Studio için Derleme Araçları yalnızca C ve C++ programları oluşturmak için ihtiyacınız olan komut satırı derleyicilerini, araçlarını ve kitaplıklarını yükler. Derleme laboratuvarları veya sınıf alıştırmaları için mükemmeldir ve nispeten hızlı bir şekilde yüklenir. Yalnızca komut satırı araçlarını yüklemek için, Visual Studio Downloads içinde Visual Studio için Build Tools öğesini arayın.

Komut satırında bir C veya C++ programı oluşturabilmeniz için önce araçların yüklü olduğunu doğrulayın ve bunlara komut satırından erişebilirsiniz. Microsoft C++ (MSVC), komut satırı ortamının kullandığı araçları, üst bilgileri ve kitaplıkları bulması için karmaşık gereksinimlere sahiptir.

Hazırlık yapmadan Microsoft C++ dosyasını düz komut istemi penceresinde kullanamazsınız. Microsoft C++, komut satırı derlemeleri için ortamı yapılandırılmış bir geliştirici komut istemi başlatabilmeniz için kısayollar oluşturur. Ne yazık ki, geliştirici komut istemi kısayollarının adları ve bulundukları konum, Visual Studio'nun hemen her sürümünde ve Farklı Windows sürümlerinde farklıdır. İlk adım göreviniz, kullanılacak doğru olanı bulmaktır.

Not

Geliştirici komut istemi kısayolu, derleyici ve araçlar için ve gerekli üst bilgiler ve kitaplıklar için doğru yolları otomatik olarak ayarlar. Normal bir Komut İstemi penceresi kullanıyorsanız bu ortam değerlerini kendiniz ayarlamanız gerekir. Daha fazla bilgi için bkz . Komut satırından MSVC araç takımını kullanma. Kendi komutunuzu oluşturmak yerine bir geliştirici komut istemi kısayolu kullanmanızı öneririz.

Geliştirici komut istemi açma

  1. Windows 10 veya sonraki sürümlerde Visual Studio 2017 veya sonraki bir sürümüne sahipseniz Start menüsünü açın ve Tüm uygulamalar'i seçin. Aşağı kaydırın ve Visual Studio klasörünü açın (Visual Studio uygulamasını değil). Komut istemi penceresini açmak için VS için Geliştirici Komut İstemi'ni seçin.

    Windows 10 veya sonraki bir sürümde Microsoft Visual Studio Build Tools 2015 yüklüyse, Başlat menüsünü açın ve Tüm uygulamalar seçeneğini belirleyin. Aşağı kaydırın ve Visual Studio Derleme Araçları klasörünü açın. Komut istemi penceresini açmak için x86 Yerel Araçlar Komut İstemi'ni seçin.

    Geliştirici komut istemini aramak ve yüklü Visual Studio sürümünüzle eşleşen bir komut istemi seçmek için Windows search işlevini de kullanabilirsiniz. Komut istemi penceresini açmak için kısayolu kullanın.

  2. C++ geliştirici komut isteminin doğru ayarlandığını doğrulayın. Komut istemi penceresinde şunu girin cl ve çıkışın şuna benzer olduğunu doğrulayın:

    C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise>cl
    Microsoft (R) C/C++ Optimizing Compiler Version 19.10.25017 for x86
    Copyright (C) Microsoft Corporation.  All rights reserved.
    
    usage: cl [ option... ] filename... [ /link linkoption... ]
    

Geçerli dizinde veya sürüm numaralarında farklılıklar olabilir. Bu değerler MSVC sürümüne ve yüklü güncelleştirmelere bağlıdır. Çıktı gördüğünüze benzerse, komut satırında C veya C++ programları oluşturmaya hazırsınız demektir.

Not

cl komutunu çalıştırdığınızda "'cl' iç ya da dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmıyor", C1034 ya da LNK1104 gibi bir hata alıyorsanız, geliştirici komut istemi kullanmıyorsunuzdur ya da MSVC yüklemenizle ilgili bir sorun vardır. Devam etmeden önce bu sorunu düzeltmeniz gerekir.

Geliştirici komut istemi kısayolunu bulamıyorsanız veya girdiğinizde clbir hata iletisi alırsanız MSVC yüklemenizde sorun olabilir. Visual Studio veya Visual Studio Derleme Araçları'nda MSVC bileşenini yeniden yüklemeyi deneyin. Komut çalışana kadar sonraki bölüme cl geçmeyin. MSVC'yi yükleme ve sorun giderme hakkında daha fazla bilgi için bkz. Visual Studio'yu Yükleme.

Not

Bilgisayardaki Windows sürümüne ve sistem güvenlik yapılandırmasına bağlı olarak, sağ tıklayarak geliştirici komut istemi kısayolunun kısayol menüsünü açmanız ve ardından bu kılavuzu izleyerek oluşturduğunuz programı başarıyla derlemek ve çalıştırmak için Yönetici olarak çalıştır'ı seçmeniz gerekebilir.

C++ kaynak dosyası oluşturma ve komut satırında derleme

  1. Geliştirici komut istemi penceresinde, bir dizin oluşturmak için girin md C:\hello ve ardından bu dizine geçmek için girin cd C:\hello . Bu dizin, hem kaynak dosyanızın hem de derlenmiş programın oluşturulduğu yerdir.

  2. Komut istemi penceresine girin notepad hello.cpp .

    Not Defteri yeni bir dosya oluşturmanız istendiğinde Evet'i seçin. Bu adım, kodunuzu adlı hello.cppbir dosyaya girmenize hazır boş bir Not Defteri penceresi açar.

  3. Not Defteri'ne aşağıdaki kodu girin:

    #include <iostream>
    using namespace std;
    int main()
    {
        cout << "Hello, world, from Microsoft C++!" << endl;
    }
    

    Bu kod, ekrana bir satır metin yazan ve ardından çıkan basit bir programdır. Hataları en aza indirmek için bu kodu kopyalayın ve Not Defteri'ne yapıştırın.

  4. Çalışmanızı kaydedin! Not Defteri'ndeki Dosya menüsünde Kaydet'i seçin.

    Tebrikler! Derlemeye hazır bir C++ kaynak dosyası hello.cppoluşturdunuz.

  5. Geliştirici komut istemi penceresine geri dönün. Dizinin içeriğini listelemek için komut istemine dir girinC:\hello. Dizin listesinde aşağıdakine benzer bir kaynak dosya hello.cpp görmeniz gerekir:

    C:\hello>dir
     Volume in drive C is Local Disk
     Volume Serial Number is AA11-BB22
    
     Directory of C:\hello
    
    04/28/2026  01:26 PM    <DIR>          .
    04/28/2026  01:26 PM    <DIR>          ..
    04/28/2026  01:27 PM               117 hello.cpp
                   1 File(s)            117 bytes
    

    Tarihler ve diğer ayrıntılar bilgisayarınızda farklılık gösterir.

    Not

    Kaynak kod dosyanızı görmüyorsanız, hello.cppkomut isteminizdeki geçerli çalışma dizininin oluşturduğunuz dizin olduğundan C:\hello emin olun. Ayrıca bu konumun kaynak dosyanızı kaydettiğiniz dizin olduğundan emin olun.

    Kaynak kodunu, .txt uzantısıyla değil, .cpp dosya adı uzantısıyla kaydettiğinizden emin olun. Komut isteminde .cpp komutunu kullanarak Not Defteri'ni açtığınızda, kaynak dosyanız geçerli dizinde notepad hello.cpp dosyası olarak otomatik kaydedilir.

    Not Defteri'ni başka bir şekilde açarsanız, Not Defteri'nin davranışı farklıdır: Not Defteri, yeni dosyaları kaydettiğinizde varsayılan olarak yeni dosyalara bir .txt uzantı ekler. Ayrıca varsayılan olarak dosyaları dizininize Documents kaydeder. Dosyanızı Not Defteri'nde bir .cpp uzantısıyla kaydetmek için Dosya'yı seçin ve >'i seçin. Farklı Kaydet iletişim kutusunda, dizin ağacı görünümü denetiminde C:\hello klasörünüze gidin. Ardından Kayıt Türü açılır menüsünü kullanarak Tüm Dosyalar (*.*) öğesini seçin. "Dosya adı düzenleme kontrolüne hello.cpp girin ve dosyayı kaydetmek için Kaydet'i seçin."

  6. Geliştirici komut isteminde, programınızı derlemek için girin cl /EHsc hello.cpp .

    cl.exe derleyicisi derlenmiş kodu içeren bir .obj dosyası oluşturur ve bağlayıcıyı çalıştırarak hello.exe adlı yürütülebilir bir program oluşturur. Bu ad, derleyicinin görüntülediği çıkış bilgileri satırlarında görünür. Derleyicinin çıktısı şuna benzer olmalıdır:

    C:\hello>cl /EHsc hello.cpp
    Microsoft (R) C/C++ Optimizing Compiler Version 19.10.25017 for x86
    Copyright (C) Microsoft Corporation.  All rights reserved.
    
    hello.cpp
    Microsoft (R) Incremental Linker Version 14.10.25017.0
    Copyright (C) Microsoft Corporation.  All rights reserved.
    
    /out:hello.exe
    hello.obj
    

    Not

    "'cl' iç veya dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmıyor" hatası, C1034 hatası veya hata LNK1104 gibi bir hata alırsanız geliştirici komut isteminiz doğru ayarlanmadı. Bu sorunun nasıl düzeltileceğini öğrenmek için Geliştirici komut istemi açma bölümüne geri dönün.

    Farklı bir derleyici veya bağlayıcı hatası veya uyarısı alırsanız, hataları düzeltmek için kaynak kodunuzu gözden geçirin, sonra kaydedin ve derleyiciyi yeniden çalıştırın. Belirli hatalar hakkında bilgi için, arama kutusunu kullanarak hata numarasını arayın.

  7. hello.exe programını çalıştırmak için komut istemine girin hello.

    Program bu metni görüntüler ve şu şekilde çıkar:

    Hello, world, from Microsoft C++!
    

    Tebrikler! Komut satırı araçlarını kullanarak bir C++ programı derleyip çalıştırmışsınız.

Sonraki adımlar

Bu "Hello, World" örneği, bir C++ programının alabildiği kadar basittir. Gerçek dünya programlarının genellikle üst bilgi dosyaları, daha fazla kaynak dosyası ve kitaplıklara bağlantısı vardır.

Gösterilen örnek kodu yazmak yerine kendi C++ kodunuzu oluşturmak için bu kılavuzdaki adımları kullanabilirsiniz. Bu adımlar, başka bir yerde bulduğunuz birçok C++ kod örneği programı oluşturmanıza da olanak sağlar. Kaynak kodunuzu ekleyebilir ve uygulamalarınızı yazılabilir herhangi bir dizinde oluşturabilirsiniz. Varsayılan olarak, Visual Studio IDE source\repos alt klasöründe kullanıcı klasörünüzde projeler oluşturur. Eski sürümler projeleri bir Documents\Visual Studio \{version}\Projects klasörüne koyabilir.

Başka kaynak kodu dosyaları olan bir programı derlemek için, bunların tümünü komut satırına girin, örneğin:

cl /EHsc file1.cpp file2.cpp file3.cpp

/EHsc Komut satırı seçeneği, derleyiciye standart C++ özel durum işleme davranışını etkinleştirmesini sağlar. Bu olmadan, atılan istisnalar imha edilmemiş nesnelere ve kaynak sızıntılarına neden olabilir. Daha fazla bilgi için bkz . /EH (Özel Durum İşleme Modeli).

Diğer kaynak dosyaları sağladığınızda, derleyici program adını oluşturmak için ilk giriş dosyasını kullanır. Bu durumda, file1.exe adlı bir program üretir. Adı program1.exe olarak değiştirmek için bir /out bağlayıcı seçeneği ekleyin:

cl /EHsc file1.cpp file2.cpp file3.cpp /link /out:program1.exe

Daha fazla programlama hatasını otomatik olarak yakalamak için /W3 veya /W4 uyarı düzeyi seçeneğini kullanarak derlemenizi öneririz:

cl /W4 /EHsc file1.cpp file2.cpp file3.cpp /link /out:program1.exe

derleyicisi cl.exe, çok daha fazla seçeneğe sahiptir. Bunları kodunuzu derlemek, iyileştirmek, hatalarını ayıklamak ve analiz etmek için uygulayabilirsiniz. Hızlı liste için geliştirici komut istemine girin cl /? . Ayrıca ayrı ayrı derleyip bağlayabilir ve daha karmaşık derleme senaryolarında bağlayıcı seçenekleri uygulayabilirsiniz. Derleyici ve bağlayıcı seçenekleri ve kullanımı hakkında daha fazla bilgi için bkz. C/C++ Derleme Referansı.

Komut satırında daha karmaşık projeler yapılandırmak ve oluşturmak için NMAKE ve makefiles, MSBuild ve proje dosyaları veya CMake kullanabilirsiniz. Bu araçları kullanma hakkında daha fazla bilgi için NMAKE Başvurusu, MSBuild ve Visual Studio'da CMake projeleri başvurularına bakın.

C ve C++ dilleri benzerdir ancak aynı değildir. MSVC derleyicisi, kodunuzu derlerken hangi dilin kullanılacağını belirlemek için basit bir kural kullanır. Varsayılan olarak, MSVC derleyicisi C kaynak kodu olarak biten .c dosyaları ve C++ kaynak kodu olarak biten .cpp dosyaları ele alır. Derleyiciyi tüm dosyaları dosya adı uzantısından bağımsız olarak C++ olarak işlemeye zorlamak için /TP derleyici seçeneğini kullanın.

MSVC derleyicisi, küçük özel durumlar dışında ISO C99 standardına uyan bir C Çalışma Zamanı Kitaplığı (CRT) içerir. Taşınabilir kod genellikle beklendiği gibi derlenir ve çalışır. Bazı eski kitaplık işlevleri ve birkaç POSIX işlev adı, MSVC derleyicisi tarafından kullanım dışı bırakılmıştır. İşlevler desteklenir, ancak tercih edilen adlar değişmiştir. Daha fazla bilgi için, CRT'deki Güvenlik Özellikleri ve Derleyici Uyarısı (düzey 3) C4996'ya bakın.

Ayrıca bkz.