Go to Qiita Advent Calendar 2024 Top
LoginSignup
14
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

@UMA821

Windows10+VSCodeでVisualStudio2019のcl.exeを使ってC＋＋デバッグ

Last updated at Posted at 2021-02-28

#動機
普段はgccを用いてビルド＆デバッグしていたが、ふとVisual Studioで使われているcl.exeでデバッグ作業がしたくなってきたから。

#注意

  • Visual Studio 2019 が既にインストールされていて、C++ のコードが実行できるように設定済みであること
  • Visual Studio Code が既にインストールされていて、C++の設定などをされていること
  • 迷走した経緯も記されているため、答えだけ知りたければ一番最後まで飛んでほしい

ここらの設定については記事が長くなってしまうので割愛させていただく。詳しくは、
C言語 VisualStudio【開発環境の構築手順を優しく図解】
Visual Studio Code のインストールと日本語化まとめ
Visual Studio Code を使った C++ のビルド＆デバッグ方法
などのサイトを参考にしてほしい。

#1. tasks.json の設定
##1.1 とりあえず実行
Configure VS Code for Microsoft C++より、

tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "shell",
      "label": "cl.exe build active file", // ビルド時の選択肢
      "command": "cl.exe",
      "args": [
        "/Zi",
        "/EHsc",
        "/Fe:",
        "${fileDirname}\\${fileBasenameNoExtension}.exe",
        "${file}"
      ],
      "problemMatcher": ["$msCompile"],
      "group": "build", //サイトのままだとビルド時にこれが自動で選択される
    },
    // 他のタスクがあれば...
  ]
}

/EHscはアンワインド セマンティクス って何？ や http://myoga.web.fc2.com/prog/cpp/intro03.htm より、

/EHsc は、「C++ 例外処理を利用します」という意味です。 何も指定しないと iostream が c++ の例外処理を使おうとして(?)コンパイル出来なくなってしまいます。

コンパイラへのパスの設定をしていないので動きそうもないがひとまず実行してみよう。
プログラムの画面でctrl+shift+bで画面上部に表示されるものの中から「cl.exe build active file」を選ぶとコンパイルが行われる。

image.png

'cl.exe' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

まあ予想通りの結果となってしまった。
"command": "cl.exe", ではパスを通していないので当たり前であろう。
ではcl.exeがどこにあるのか調べなければならない。

各々によって異なるだろうが、私の場合は
D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.24.28314/bin/Hostx64/x64/cl.exe
にあったので、
"command": "D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.24.28314/bin/Hostx64/x64/cl.exe",
に書き換えて実行してみる。

helloworld.cpp
D:\VScode\C\helloworld.cpp(1): fatal error C1034: iostream: インクルード パスが設定されていません。

自動でインクルードディレクトリを探してくれないようである。
##1.2 インクルードディレクトリの指定
(2019年版)コマンドラインからclを使ってコンパイルできるようにしたので共有する
より、「x64 Native Tools Command Prompt for VS 2019」を起動して、
echo %INCLUDE% と打ち込む。

image.png

D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\ATLMFC\include;
D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\include;
C:\Program Files (x86)\Windows Kits\NETFXSDK\4.8\include\um;
C:\Program Files (x86)\Windows Kits\10\include\10.0.18362.0\ucrt;
C:\Program Files (x86)\Windows Kits\10\include\10.0.18362.0\shared;
C:\Program Files (x86)\Windows Kits\10\include\10.0.18362.0\um;
C:\Program Files (x86)\Windows Kits\10\include\10.0.18362.0\winrt;
C:\Program Files (x86)\Windows Kits\10\include\10.0.18362.0\cppwinrt

これらを環境変数に登録するのもいいが、せっかくだからコンパイラオプションで指定してみたい。
/I (追加のインクルードディレクトリ) より、/I directory の形式で書けば良いようなので、"args"の中身を

"args": [
  "/Zi",
  "/EHsc",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\include",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\include",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\include\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\ucrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\shared",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\winrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\cppwinrt",
  "/Fe:",
  "${fileDirname}\\${fileBasenameNoExtension}.exe",
  "${file}"
],

に変更して再実行
LIBとLIBPATHの指定はしていないので、エラーになるのだろう。

helloworld.obj
LINK : fatal error LNK1104: ファイル 'libcpmt.lib' を開くことができません。

やはりか...

##1.3 Libディレクトリの指定
リンカ ツール エラー LNK1104 より、

ファイル 'C:\Program.obj' を開くことができません

コマンドラインビルドのこの問題を解決するには、 /LIBPATH オプションのパラメーターを確認します。 また、LIB 環境変数で指定されたパスと、コマンドラインで指定されたパスも確認します。 スペースを含むパスは必ず二重引用符で囲んでください。

なるほど、これもオプションで指定できそうだ。
/LIBPATH (追加ライブラリのパス)より、/LIBPATH:dirの形式で書けば良いようである。
ということで、さっきの「x64 Native Tools Command Prompt for VS 2019」に、
echo %LIB% と打ち込む。

D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\ATLMFC\lib\x64;
D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\lib\x64;
C:\Program Files (x86)\Windows Kits\NETFXSDK\4.8\lib\um\x64;
C:\Program Files (x86)\Windows Kits\10\lib\10.0.18362.0\ucrt\x64;
C:\Program Files (x86)\Windows Kits\10\lib\10.0.18362.0\um\x64;

なので"args"の中身を、

"args": [
  "/Zi",
  "/EHsc",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\include",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\include",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\include\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\ucrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\shared",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\winrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\cppwinrt",
  "/Fe:",
  "${fileDirname}\\${fileBasenameNoExtension}.exe",
  "${file}",
  "/LIBPATH:D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\lib\\x64",
  "/LIBPATH:D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\lib\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\lib\\um\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\ucrt\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\um\\x64",
],

これで実行してみる。

cl : コマンド ライン warning D9002 : 不明なオプション '/LIBPATH:D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\ATLMFC\lib\x64' を無視します。
cl : コマンド ライン warning D9002 : 不明なオプション '/LIBPATH:D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.24.28314\lib\x64' を無視します。
cl : コマンド ライン warning D9002 : 不明なオプション '/LIBPATH:C:\Program Files (x86)\Windows Kits\NETFXSDK\4.8\lib\um\x64' を無視します。
cl : コマンド ライン warning D9002 : 不明なオプション '/LIBPATH:C:\Program Files (x86)\Windows Kits\10\lib\10.0.18362.0\ucrt\x64' を無視します。
cl : コマンド ライン warning D9002 : 不明なオプション '/LIBPATH:C:\Program Files (x86)\Windows Kits\10\lib\10.0.18362.0\um\x64' を無視します。

調べたところ、/LIBPATH はリンカオプションであり、
リンカにオプションを渡すためには、Compiler-Controlled LINK Options より、/link の後に書かなければいけないのだとか。
よって"args"の中身を、

"args": [
  "/Zi",
  "/EHsc",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\include",
  "/I",
  "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\include",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\include\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\ucrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\shared",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\um",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\winrt",
  "/I",
  "C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\cppwinrt",
  "/Fe:",
  "${fileDirname}\\${fileBasenameNoExtension}.exe",
  "${file}",
  "/link",
  "/LIBPATH:D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\lib\\x64",
  "/LIBPATH:D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\lib\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\lib\\um\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\ucrt\\x64",
  "/LIBPATH:C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\um\\x64",
],

として実行したところ、エラー無くビルドできた。

#2. launch.json の設定

Configure VS Code for Microsoft C++より、

launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "cl.exe build and debug active file", // デバッグ時の選択肢
      "type": "cppvsdbg",
      "request": "launch",
      "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      //"console": "newExternalWindow", //外部タイミナル上で出力
      "console": "integratedTerminal", //内部ターミナル上で出力
      //"externalConsole": false, //非推奨
      "preLaunchTask": "cl.exe build active file"
    },
    // 他の構成があれば...
  ]
}

実行するにはctrl+shift+dで出てきた画面から選択すればいいので、
image.png

image.png

これでデバッグができるようになった。

#3. tasks.json の設定(改)

ここまでの設定でデバッグができるようになったのだが、
【VSCode tips】VSCode で go buildする設定 【#1】より、
optionディレクティブ及びenvディレクティブを用いて環境変数の指定を行えるようである。よって、

"options": {
  "env": {
    "INCLUDE": "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\include;D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\include;C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\include\\um;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\ucrt;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\shared;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\um;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\winrt;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\cppwinrt",
    "LIB": "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\lib\\x64;D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\lib\\x64;C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\lib\\um\\x64;C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\ucrt\\x64;C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\um\\x64;",
  }
},

を追加し、/I オプションと、/LIBPATH オプションを削除すれば "args" の中身が見やすくなるであろう。

#4. 結果

tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "shell",
      "label": "cl.exe build active file",
      "command": "D:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.24.28314/bin/Hostx64/x64/cl.exe",
      "args": [
        "/Zi",
        "/EHsc",
        "/source-charset:utf-8", //日本語文字化け対策 https://torakichi.hateblo.jp/entry/2017/03/04/152827 より
        "/std:c++17",
        "/Od", //最適化無効
        "/Fe:",
        "${fileDirname}\\${fileBasenameNoExtension}.exe",
        "${file}"
      ],
      "options": {
        "env": {
          "INCLUDE": "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\include;D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\include;C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\include\\um;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\ucrt;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\shared;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\um;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\winrt;C:\\Program Files (x86)\\Windows Kits\\10\\include\\10.0.18362.0\\cppwinrt",
          "LIB": "D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\ATLMFC\\lib\\x64;D:\\Program Files (x86)\\Microsoft Visual Studio\\2019\\Community\\VC\\Tools\\MSVC\\14.24.28314\\lib\\x64;C:\\Program Files (x86)\\Windows Kits\\NETFXSDK\\4.8\\lib\\um\\x64;C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\ucrt\\x64;C:\\Program Files (x86)\\Windows Kits\\10\\lib\\10.0.18362.0\\um\\x64;",
        }
      },
      "problemMatcher": ["$msCompile"],
      "group": "build",
    },
    // 他のタスクがあれば...
  ]
}
launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "cl.exe build and debug active file", // デバッグ時の選択肢
      "type": "cppvsdbg",
      "request": "launch",
      "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      //"console": "newExternalWindow", //外部タイミナル上で出力
      "console": "integratedTerminal", //内部ターミナル上で出力
      //"externalConsole": false, //非推奨
      "preLaunchTask": "cl.exe build active file"
    },
    // 他の構成があれば...
  ]
}
14
9
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
14
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?