This extension add cscope support for Visual Studio Code. Supports C/C++ only (all other languages are not tested). This extension is still in preliminary stage. For any issue you have, pleases log it here. Your help can improve this extension.

Visual Studio Code C/C++ extension has support for symbol parsing and searching, which is based on Clang tag system. However, when working with a very large projects (over 10K files), it could be very slow and annoying (based on my experience):

• It would try search all the folders for all source code while creating database. It takes hours to build the database.
• There is no option to ignore symbolic link (Leaves no chance for developer to optimize the build, unless developper is happenly using CMake system).
• No easy way to exclude unwanted file when the project structure is complex.
• Every time when code is changed, it tries to update the database which might take another hour or so. If developper is keep changing code, the extension will keep running and keep occupying a lot of processor time.

scope4code uses cscope, which works very well with large project. Database build time normally withing 1 minutes and search is extremely fast (at least with Linux filesystem).

• Dependency:

  • In order to use this extension, cscope shall be installed and accessible via command line. The extension is designed to call 'cscope' command line to get everything done. If for some reason cscope is not able to be called from a default shell, a path could be added to following setting (replace <cscope_path> with full path):

  "scope4code.executablePath": "<cscope_path>"
  

  For windows user: pls download cscope from here. Extract the exe after download and add path to user or system evironment. For Linux user: Do not use ~/ in <cscope_path>. It has to be the full absolute path (e.g. if cscope is in ~/bin, shall replace <cscope_path> with "/home/user_a/bin").

• Build database:

  • Press F1 or Ctrl+Shift+P to open command window, select "Cscope: Build database" to start building.

• Find all references

  • Once database is ready to use, right click on a symbol then select "Find All References" to find all occurence of the symbol.

• Find definition

  • Once database is ready to use, right click on a symbol then select "Go to Definition " to find all possible definition of the symbol.

• Other commands via F1:

  • Cscope: Find this C symbol (same as "Find all references").
  • Cscope: Find this function definition (same as "Find definition").
  • Cscope: Find functions called by this function.
  • Cscope: Find functions calling this function.
  • Cscope: Find this text string.

• Configuration:

  • Configuration is supported via cscope_conf.json. This file will be automatically creted in .vscode folder once the extension is enabled.
  • Below settings are supported:
    • open_new_column - This flag controls how shall new .find window shall be opened. 'yes' means it shall be opened in a separate column while 'no' will open in a new tab. Default setting is no since v0.0.5.
    • engine_configurations.cscope.paths - This is an array of the paths where all source code files need to be parsed. It allows to include paths that outside of the vs code project. Default value is ${workspaceRoot}.
    • engine_configurations.cscope.database_path - The path indicates where the cscope database should be built/and found. Default value is ${workspaceRoot}/.vscode/cscope as this was the default path before.

• Command customization

  • Starting from version 0.1.00, customized command is supported. By updating setting "scope4code.engineCommands", all commands used by this extension could be customized. Below example shows a setting with updated the search and find ref command for Linux and build command for Windows:

  scope4code.engineCommands : {
      "config_index" : {
          "cscope" : {
              "win32" : 1,
              "linux" : 0
          }
      },
      "config": [
          {
              "find_cmd": "find ${src_path} -type f -name *.c -o -type f -name *.cpp",
              "find_all_ref" : "cscope -L0 ${text}",
          },
          {
              "database_cmd": "cscope -b -k"
          }
      ]
  }
  

  • engineCommands reference
    Customizable commands:

  field	description
  find_cmd	Command to list all source files
  database_cmd	build database
  find_all_ref	find all reference of a symbol
  find_define	find definition of a symbol
  find_callee	find functions called by this function (symbol)
  find_caller	find functions calling this function (symbol)
  find_text	find this text string

  Built-in variables: There are variables defined could be used (some has to, such as ${text}) to build command. Here is a list of supported variables:

  name	description
  ${src_path}	source folders configured in engine_configurations.cscope.paths, by default (if not configured) this would be workspace path
  ${database_path}	path where database file would be generated. It's configured via engine_configurations.cscope.database_path. It's .vscode/cscope by default (if not configured)
  ${text}	text (symbol) to be searched
  ${workspaceRoot}	workspace root of current vscode window